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NEW RELEASES, VERSIONS , AND A WARNING 


Any programming endeavor of the magnitude of the MDBS software will 
necessarily continue to evolve over time. Realizing this, Micro Data 
Base Systems, Inc., vows to provide its users with updates to this 
version for a nominal handling fee. 

New versions of MDBS software will be considered as separate products. 
However, bona fide owners of previous versions are generally entitled 
to a preferential rate structure. 

Finally, each copy of our software is personalized to identify the 
licensee. There are several levels of this personalization, some of 
which involve encryption methods guaranteed to be combinator ially 
difficult to decipher. Our products have been produced with a very 
substantial investment of capital and labor, to say nothing of the 
years of prior involvement in the data base management area by our 
principals. Accordingly, we are seriously concerned about any 
unauthorized copying of our products and will take any and all 
available legal action against illegal copying or distribution of our 
products. 
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PREFACE 


By the mid-1960s, application developers were well aware of the 
data handling limitations of programming languages and file management 
systems. To overcome these limitations, data base management systems 
began to appear. By 1971, four major approaches to data base 
management had taken shape: the hierarchical, shallow-network, 
relational, and CODASYL-network approaches to logical data structuring 
and manipulation. Each represented an advance over the old file- 
oriented data handling methods and the latter two approaches offered 
advances over the former two. By the mid-1970s, data base management 
software was well established as the cornerstone for application 
development on mainframes and some mini computers. 

Near the end of the decade, microcomputers — with their 
phenomenal computing power on a per dollar basis — began to 
proliferate. The acceptance of mainframe data base management systems 
coupled with the rise of microcomputers led to the formation of Micro 
Data Base Systems Incorporated by a group with expertise in both 
areas. The initial objective was to make genuine data base management 
tools available in the micro realm. This objective was fulfilled in 
1979 with the release of MDBS I — the first authentic and viable data 
base management system (dbms) for microcomputers. Over the years, 
this has evolved into the present MDBS III which operates not only on 
many microcomputers but on larger machines as well. The evolution of 
MDBS III is highlighted with many firsts: first micro dbms with 
built-in logging and recovery, first full implementation of a 
postrelational dbms, first multiuser micro dbms, first dbms to run 
under PCDOS, MSDOS and UNIX. 

Today, MDBS III offers professional application developers a 
degree of power and flexibility unavailable with any other data base 
management software — be it on micros, minis or mainframes. This is 
partially due to the highly efficient, proprietary implementation 
techniques. MDBS III is not a mainframe retread shoehorned into a 
microcomputer. It is also due to the innovative data modeling 
features that MDBS III provides. Because these features go far beyond 
those of the older data base management approaches, MDBS III is 
variously referred to as postrelational or multiarchical or extended- 
network. The emphasis in this approach to data base management is on 
direct, natural representation of the application world. The result 
is a tremendous increase in developer productivity. As stated in the 
authoritative Database - the 2nd Generation: State of the Art Report 
(ed., D. J. L. Gradwell, Pergamon Press, Oxford, England, 1982): 

"The data modelling capability of MDBS III is superior to any 
other commercially available DBMS." MDBS III is " . . . a product 
that is, in many ways, ahead of mainframe DBMSs." (D. J. L. 
Gradwell) 

All of this translates into convenience for application system 
developers and administrators. 
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The MDBS R&D Lab’s expertise in the areas of decision support 
systems and artificial intelligence has resulted in two unique 
environments for processing MDBS III data bases. One is a decision 
support environment called KnowledgeMan. It functions as a universal 
knowledge management system, allowing users to represent and process 
knowledge in many different ways -- including spreadsheets, text, 
graphics, forms, procedural models, relational data bases, and 
post relational MDBS III data bases. The second is a revolutionary 
artificial intelligence environment called Guru. It makes the 
benefits of both expert system technology and natural language 
processing easily accessible to business users, without sacrificing 
familiar business computing capabilities. MDBS III data base contents 
are directly accessible within the Guru environment. 

This manual provides details on the features and utilization of 
the MDBS Data Manipulation Language. Companion manuals discuss the 
MDBS Data Description Language and various optional modules. This 
manual is not intended to be a tutorial. For a tutorial treatment of 
data base management (including its many advantages over file 
management), the reader is advised to consult such suitable references 
as: 


Academic Press, 


by R. H. Bonczek, 
York, 1984. 


"A Perspective on Data Models," 
1, 1934. 


„, Vol. 2, No. 


3. 


"Micros Get Mainframe Data Scheme, 
Vol. 3, No. 5, 1984. 



4. 


"Uniting Relational and Post relational Database Management 
Tools," Sysfcg.ms..and. .Software., vol. 3, No. li, 1984. 


The first reference provides the most definitive coverage to date of 
the postrelat ional approach, comparing and contrasting it with the 
four older data base management approaches. That book also includes 
extensive examples of MDBS III usage. It is available through your 
local bookstore, from the publisher, or from MDBS, Inc. For many 
years, the Company has offered practical MDBS III training seminars in 
major cities and at customer sites. 
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The MDBS, Inc. commitment to customer success does not stop with 
software innovation, quality and support. The Company offers a full 
range of consulting and application development services to clients 
through its regional offices in the Dallas its regional Chicago and 
New York areas. Services include: 

1. Customized application systems design 

2. Customized application systems development using Guru, 
KnowledgeMan and/or the MDBS III tools 

3. Communications interfaces including mainframe-micro links 

4. Special training on a wide variety of topics including 
specific application systems, C programming, MDBS III usage, 
and Guru usage 

5. General consulting including feasibility studies and 
hard ware/ soft ware recommendations 

The experienced, professional staff handles consulting and application 
development needs of some of the world's largest corporations and 
governments. It has developed very extensive micro application 
systems in such diverse areas as cash management, strategic planning, 
human resources administration, waste disposal management, and 
distributed service support. In many cases, these application systems 
have involved multiuser processing or mainframe-micro links. 
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I. OVERVIEW 


A. Organization 

This is the MDBS DMS Manual. It is the second component in the 
set of MDBS Reference Manuals and assumes the reader is familiar with 
data description facilities presented in the MDBS DDL Manual. This 
document describes the MDBS III Data Manipulation Language (DML) and 
the effect that each DML command has on the behavior of the data base 
control system (MDBS. DMS) . The MDBS DMS Manual is written on two 
levels: fundamental manipulation features and advanced manipulation 
features. An understanding of the fundamentals is sufficient for 
developing useful application systems. The advanced features are 
denoted by a vertical bar in the outside margin. These are perhaps 
less frequently needed, but they are valuable for certain special 
kinds of data manipulation. 

The documentation in this manual is applicable to both Versions 
3a and 3c. Appendix A describes those data manipulation features that 
are applicable only to Version 3a. It is also independent of the host 
language (s) selected to interface with MDBS. DMS. Host language- 
dependent aspects of the interface are described in appropriate MDBS 
System Specific Manuals. 

The remainder of this chapter outlines the role of MDBS. DMS 
software and its associated data Manipulation Language (DML) , in 
application development. Chapter II provides the detailed background 
that is necessary to effectively use the MDBS Data Manipulation 
Language. Each of Chapters III through XV documents a class of DML 
commands. The individual commands in each class are presented 
alphabetically and the function of each command is described. When a 
DML command is executed, MDBS. DMS reports on the status of that 
command's execution. Each possible command status is explained in 
Chapter XVI. 


B. The Role of DML in Application Development 

The MDBS Data Manipulation Language consists of a group of 
commands, each of which performs some data manipulation task. A DML 
command is stated within an application program. The programming 
language used to write an application program is called the host 
language . A DML command is typically invoked as a function in the 
host language. When a DML command is given, the MDBS. DMS software 
carries out the actual data manipulation. This could involve storing 
data from a host program variable into the data base. Conversely, it 
could involve extracting data from the data base and depositing it in 
a host language variable. Many other kinds of data manipulation are 
supported. In effect, the DML extends the data handling capability of 
a programming language, so that programs can utilize MDBS data bases 
in addition to traditional files. 

Usage of the MDBS DML in developing an application program 
depends only upon a knowledge of the data base's logical structure. 
The application programmer need not be concerned with using pointers, 
searching indices, disk I/O, file handling, free space management, 
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etc. All of these factors are automatically handled by the MDBS .DMS 
software. Furthermore, all data manipulation occurs subject to the 
security and integrity constraints defined in a data base's DDL 
specification. In a multiuser environment, MDBS.DMS manages record 
lockout to prevent such problems as one user attempting to modify a 
record that another user is reading. Special DKL commands are 
available to the application programmer who (beyond the standard 
passive lockouts) desires to actively lock out records, record types, 
or sets. 

A data manipulation language provides a procedural approach to 
data manipulation. It can therefore be contrasted with a query 
language, which provides a nonprocedural approach to data 
manipulation. From the standpoint of achieving the highest 
performance for application software, using a DHL is inevitably 
superior to using a nonprocedural query language. On the other hand, 
the application developer who is not experienced in using DML can very 
likely achieve more rapid development by using a nonprocedural query 
language (at the expense of a sacrifice in per] Mrmance) . In data base 
management systems that do not support both a DML and a query 
language, the application developer has no choice. Both kinds of 
languages are available with MDBS. It is recommended that the query 
language (see the MDBS QRS Manual) be used in situations where the 
need for rapid development outweighs the need for optimal performance. 
If optimal performance is the overriding consideration, then the MDBS 
DML is most appropriate. In addition to QRS, there are other optional 
access modules including IDML, IBS, RDL and BLF. 

Although the MDBS DML makes many commands available, it is 
typically the case that an application developer will need to use only 
a few kinds of DML commands in any given application program. Across 
all application programs, there is a small group of about a dozen DML 
commands that tend to be heavily used. Varying degrees of selective 
MDBS.DMS linking are permitted, depending on the host language used 
(see MDBS System Specific Manuals for details). In other words, only 
that part of MDBS.DMS that is needed to execute an application 
program's DML commands is held in main memory. Since the entire 
MDBS.DMS software is not in main memory, there is more memory 
available for a larger application program or a larger page buffer 
region. 

One component of MDBS.DMS performs virtual buffer paging, based 
on an enhanced least-recently-used page replacement algorithm. When a 
DML command is executed, MDBS.DMS determines whether images of all 
needed pages are in main memory. If needed pages are not resident, 
MDBS.DMS has them read into main memory. The larger the page buffer 
region in main memory, the more likely it is that needed pages are 
resident and the faster the processing will be. Thus it is important 
for the application developer to allow as large a page buffer region 
as possible. In a single-user environment, the page buffer region 
size is directly assigned by the programmer. In a multiuser 
environment, MDBS.DMS determines the size of the page buffer region 
that is shared by all users (i.e., simultaneously executing 
application programs). 
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II. GENERAL BACKGROUND 


A. Data Transfer 

Some DML commands pass data from a host language variable into 
the data base. Others retrieve data from the data base into a host 
language variable, from which the data can then be used for 
computation or program output. There are two basic approaches for 
allowing MDBS. DMS to accomplish the data transferral between a data 
base and an application program. The approach used depends on the 
nature of the host programming language. Non-record-oriented 
languages (such as BASIC) require the data block approach. Host 
languages with a facility for defining program record types (e.g., 
COBOL, PL/1, PASCAL) use the program record type approach. Full 
details of the approach used for a particular host language appear in 
the MDBS System Specific Manual for that host language. 

1. Data Elects. A data block is a named sequence of one or 
more host language variables. MDBS DML commands exist to 
define, extend, and undefine data blocks (see Chapter XIII). 
A given host language variable can participate in many data 
blocks. A DML command to put data into a data base has a 
data block name as one of its arguments. The value(s) of 
the host language variable(s) for that data block is(are) 
put into the data base. A DML command to retrieve data from 
a data base has a data block name as one of its arguments. 
The retrieved value(s) becomes the new value (s) for the data 
block's host language variable(s). 

2. Ercsnnm Beccrd Types- A program record type plays the same 
role as a data block. It is a named sequence of one or more 
host language variables. It is not defined with DML 
commands, but is specified with the host language's facility 
for defining program record types (for example, a 01 level 
entry in a COBOL working storage section, or a record 
structure of C or PASCAL). A given host language variable 
usually cannot participate in more than one program record 
type. A DML command to put data into a data base has a 
program record type name as one of its arguments. The 
value(s) of the host language variable(s) for that program 
record type is(are) put into the data base. A DML command 
to retrieve data from a data base has a program record type 
name as one of its arguments. The retrieved value(s) 
becomes the new value (s) of the program record type's host 
language variable(s). 


B. Currency Indicators 


Currency indicatcrs are used by 
track of which record occurrences 
interest. MDBS. DMS maintains two 
specified in a data base's schema: 
the current member of the set. 


an application programmer to keep 
in a data base are currently of 
currency indicators for each set 
the current QHner of the set and 
There can be many owner record 
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occurrences in the data base for a given set. At any moment during 
the execution of an application program no more than one of those 
owner record occurrences is the Ciilisnt owner of the set. DML 
commands allow the application programmer to control which (if any) 
owner record occurrence is the current owner of a set. The £Y£IEfl 
LfiCQLd £££U£££n££ is always the fiiirieut saner flf eyexy systemrCMned 
set (unless it is explicitly made to be null by the programmer). 
Similarly, there can be many member record occurrences in the data 
base for a given set. At any moment during the execution of an 
application program, no more than one of those member record 
occurrences is the set's £££ient member. DML commands allow the 
application programmer to control which (if any) member record 
occurrence is the current member of a set. 

As soon as a record occurrence becomes the current owner of a 
set, the DML can be used: 

to find any of its related members through that set (Chapter III), 
to modify its data values (Chapter V) , 
to retrieve its data values (Chapter IV) , 

to delete the record occurrence from the data base (Chapter X) , 
etc. 

As soon as a record becomes the current member of a set, the DML can 
be used: 

to find any of its related owners through that set (Chapter III) , 
to delete the record from the data base (Chapter IX) , 
to modify its data values (Chapter V) , 
to retrieve its data values (Chapter IV) , 
etc. 

Another kind of currency indicator that can be used during data 
manipulation is called the euiient cf the nm unit. A run unit is an 
executing instance of an application program. There are many record 
occurrences in a data base. At any moment during the execution of an 
application program, no more than one record occurrence in the entire 
data base is the current record of that run unit. The current of a 
run unit is typically the record that was most recently found by the 
application program (i.e., by the run unit). DML commands allow the 
application programmer to control which (if any) data base record is 
the current of run unit. As soon as a record becomes the current of 
run unit, the DML can be used: 

to delete the record from the data base (Chapter IX) , 
to modify its data values (Chapter V) , 
to retrieve its data values (Chapter IV) . 

Suppose a data base schema has five sets. These can be any 
mixture of 1:1, 1:N, N:l, N:M sets. An application program can make 
use of any of eleven currency indicators. There are five current 
owner indicators (one per set), five current member indicators (one 
per set), and the current of run unit. In a multiuser environment, 
each application program that is using this data base will have its 
own eleven currency indicators. 
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In addition to the three kinds of currency indicators already 
mentioned, MDBS allows an application programmer to optionally define 
additional currency indicators within the scope of an application 
program. No more than 255 user-defined currency indicators can be used 
within an application program. These additional currency indicators 
can be usefully employed to "remember" the current owner of some set, 
before processing causes that current owner to change. The same 
principle can be applied to current members and the current of run 
unit. Various D ML commands can be used in subsequent processing to 
access the remembered record. DML commands are also provided for the 
user (i.e., application programmer) to define additional currency 
indicators and to make the record that is a set's current owner (or 
member or current of run unit) the current record for a user-defined 
currency indicator. 

All currency indicators are null when an application program 
begins execution, except the current owner of each system-owned set 
and the current of run unit, which also has the SYSTEM record as its 
current record. A currency indicator remains null until a DML command 
is executed to change it. 


C. Classes of DML Commands 

The DML commands fall into thirteen classes. Each command class 
has one chapter devoted to it. The order of presentation for these 
classes is as follows: 

Finding records (Chapter III) 

Retrieving data from records (Chapter IV) 

Modifying data in records (Chapter V) 

Assigning currency indicators (Chapter VI) 

Creating records (Chapter VII) 

Connecting records (Chapter VIII) 

Disconnecting records (Chapter IX) 

Deleting records (Chapter X) 

Utilities (Chapter XI) 

Boolean operations (Chapter XII) 

Special operators (Chapter XIII) 

Multiuser locking (Chapter XIV) 

Recovery operators (Chapter XV) 

The DML commands within a given class are presented alphabetically in 
the chapter for that class. In becoming acquainted with this manual, 
it is recommended that these chapters be examined in sequence. Also, 
the reader may want to ignore the advanced manipulation features on 
the initial pass through this manual. 


D. Stating a DML Command 

Each DML command consists of a short mnemonic. For instance, the 
mnemonic FFM is used for finding the first member record connected to 
the current owner of a set. A list of zero, one, two, or three 
arguments is stated along with a DML command. An argument is either a 
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set name, record type name, area name, data item name, or data 
block/program record name. For example, FFM needs a single argument: 
a set name, to indicate for which set we want to find the first 
member. Correct usage of a DML command depends on a knowledge of the 
kinds of arguments required by that command. If one of the arguments 
is a data block (or program record), the application programmer must 
be aware of whether the command will use the data block’s variables as 
inputs or outputs. 

A DML command can use currency indicators and can change currency 
indicators. An application programmer must know which currency 
indicators a DML command can use and which currency indicators it can 
alter (and the nature of the alterations) . 


Command Status 

The execution of a DML command always results in a ccmiDand 
Status- A command status is an integer in the range from 0 through 
255. The command status number is returned as the value of a host 
language variable of the programmer's choosing. A command status of 0 
means that the execution of a command was successfully completed. A 
command status of 255 means that the data manipulation system tried to 
find a record occurrence indicated by the command, but that the 
indicated record occurrence does not exist in the data base. Any 
other command status means that the command did not execute normally. 
Generally speaking, this is caused by either faulty logic of the 
programmer, a mis-statement of the command, an attempt to violate 
security or integrity constraints specified in the DDL, failure to 
have a needed disk on-line, or a hardware malfunction. A detailed 
description of each such command status error appears in Chapter XVI. 


Command Form 

The precise syntax employed for stating a DML command depends on 
the host language being used. The MDBS System Specific Manual for a 
given host language shows the syntax for using DML within that host 
language. There are four major categories of host language 
interfaces : 


a) 

Data block oriented with direct 
some FORTRANs, some BASICS) 

DML invocation 

(e.g. , 

b) 

Data block oriented with indirect DML invocation (e.g., 

some 


BASICS) 



c) 

Record oriented with direct DML invocation (e.g., C, 

some 


PASCALS, PL/1) 



d) 

Record oriented with indirect DML 
PASCALS, some COBOLs) 

invocation (e.g., 

some 


A host langu 
record types; 
DML command 
mnemonic to 


age is data block 
otherwise, it is 
directly means 
be treated as a 


oriented if it does not allow program 
said to be record oriented. Invoking a 
that the host language allows a DML 
host language function. This is not 
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allowed in the indirect case, where a DML mnemonic and its associated 
arguments are parameters of a function. For instance, in the direct 
case the FFM command has the following generic form: 

EO = FFM ("arguments") 

where EO is a host language variable that receives the command status 
value returned by the FFM function. In the indirect case, the FFM 
command has the following generic form: 

EO = DMS ("FFM, arguments") 

where EO is a host language variable that receives the command status 
returned by the DMS function as a result of executing the FFM command. 


Command String 

When a DML command is stated, the portion of that command within 
quotes is called the command string.* Two elements in a command 
string are separated by 

a series of one or more blanks, 
a comma, or 

a comma embedded in a series of blanks. 

Two consecutive commas, without an intervening nonblank character, 
indicate a missing element in a command string (e.g., "X,,Y"). A 

command string with one fewer than the permitted number of elements is 
typically treated as if the rightmost element is missing (e.g., if 
three elements are permitted, then the rightmost element is regarded 
as missing from "X,Y"). The exception is when the omitted element 
should have been a data block name (or program record type name) 
immediately following a data item or record type name (e.g., with the 
CRS command). In this case, the data block name is assumed to be the 
same as the record type or data item name (e.g., if Z is a data item 
name, then "X,Z" is equivalent to "X,Z,Z"). 

All elements are missing from a command string if there are no 
elements in the quotes. For some DML commands, it is permissible for 
an argument in a command string or the entire command string to be 
'missing (e.g., FFS ) . Some DML commands have no command string (e.g., 
DBCLS) . 


Command Descriptions 

As each DML command is described in the following chapters, 
examples of the four different categories of command usage are 
provided. Even within a category, the exact syntax for using a 


* 

Some host languages do not use double quotes (""). The exact 
convention employed by a host language is described in its system 
specific manual. 
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command may differ slightly from one host language to another. To 
repeat, the appippiiats system spesifis manual should he consulted ton 
the exact syntax lepulxed hy a giyen host language. The mnemonic, 
arguments, currency indicators used, currency indicators changed, and 
impact on the data base for each DML command are all independent of 
the host language used. All of these factors are described in 
subsequent chapters of the MDBS DMS Manual. Thus the logic employed 
in using the data manipulation language is the same, regardless of the 
host languages used. 

In presenting the DML commands in subsequent Chapters, the 
following conventions are used: 

EQ. host language variable for the command status 
aim the name of a data item defined with the DDL 
££C the name of a record type defined with the DDL 
Sfitrlx SfiizZj. the names of sets defined with the DDL 

UICU the name of an area defined with the DDL 
blJ& the name of a data block (or program record type) 
iblJs. the name of a data block (or program record type) whose host 
language variables provide input to a DML command 
eblk the name of a data block (or program record type) whose host 
language variables receive output from a DML command 
CJ2I1 current of run unit indicator 
CQiSfiil current owner of the indicated set 
CMiCfiPl current member of the indicated set 
CEi.il current user-defined indicator i (liii255) 

for example, CU(7) denotes the current record for the 
seventh user-defined indicator 

Although the description for a DML command may refer to a data block, 
it should be understood that a program record type takes the place of 
a data block for record-oriented host languages. 


E. Multiuser Environment 

In a multiuser environment, many run units can simultaneously 
share the same copy of serially reentrant MDBS. DMS code. They also 
share a common page buffer area. Each run unit has its own program 
region, which contains the application program and program buffers. A 
run unit's program buffers are used by MDBS. DMS to manage the specific 
operations pertinent to that run unit. Each run unit has its own 
group of currency indicators, which are maintained independently of 
other run units' currency indicators. 

A run unit can passively and actively lock various record 
occurrences to prevent them from being altered and/or read by other 
run units. The rules governing active and passive locking are 
presented in Chapter XIV. Also presented in that chapter are the DML 
commands for active locking and unlocking and for controlling the 
number of times (and the time interval length) that a DML command will 
re-try to access a previously locked record. 
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Built-in to the multiuser MDBS. DMS is a mechanism that allows an 
application developer to prevent both binary and n-ary deadlock 
situations. If a run unit attempts an access that will create a 
deadlock situation/ a command status error to that effect is returned 
for the DML command that attempted the access. The run unit can use 
this information in its control structure to avoid a deadlock 
situation. 


F. Protecting Data Base Consistency against External Factors 

When a run unit opens a data base for processing, it can specify 
read-only processing. If this is the case, then page images in the 
page buffer region are always identical to their corresponding pages 
in the data base (i.e., in auxiliary memory). Thus data base 
consistency is not damaged by an abnormal interruption (e.g., power 
failure) of the run unit, which does not allow the run unit to close 
the data base. 

If a run unit does not open the data base for read-only 
processing, then the run unit can alter the data base. Since these 
alterations are necessarily buffered through the page buffer region, 
it can happen that a page image in this region is not identical to the 
corresponding data base page. An abnormal interruption of the run 
unit could leave the data base inconsistent since the latest changes 
to page images in main memory might not have been written to the data 
base. When this occurs, subsequent efforts to open the data base 
yield a command status error of 15. A backup copy of the data base 
must be used in this event or the recovery utility furnished with the 
RTL form of MDBS can be used to restore the data base. There are two 
ways to drastically reduce the likelihood of such a situation. 

One method makes use of a DML command (DBSAVE) that rewrites all 
changed page images into the data base. This memory flushing command 
can be used wherever and whenever desired in an application program. 
If, when a run unit abnormally terminates, no changes have been made 
to the page images in memory since the last flush, then the data base 
is consistent and error 15 will not occur in a subsequent attempt to 
open the data base for processing. 

The second method is available with the RTL form of MDBS in 
single user situations. It allows the run unit to specify a page-image 
file via the PIFD command. This method of preserving consistency is 
particularly useful if the run unit carries out a complex kind of 
transaction that can change records on several pages. At some moment 
during the execution of a complex transaction, some changed page image 
may have been rewritten into the data base, while other altered images 
may still reside in the buffer region. An abnormal termination at 
this point would leave the data base inconsistent. If the data base 
could be restored to its former state, that existed at the start of 
the complex transaction, then that data base would be consistent and 
the interrupted transaction could be reinitiated. This is the purpose 
of the page image file. 
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At any juncture in a run unit, the TRBGN command can be used to 
declare the beginning of a complex transaction. When a commit 
(TRCOM) command is invoked, the entire complex transaction is 
committed to the data base. All changes made since TRBGN was last 
invoked are incorporated into the data base. If an abort (TRABT) 
command is invoked instead of TRCOM, no changes that were made since 
TRBGN was last invoked are incorporated into the data base. If the 
run unit abnormally terminates after a TRBGN and before a TRABT or 
TRCOM, then a subsequent command to open the data base finds the data 
base in the state that existed at the beginning of the complex 
transaction. With operating systems that do not dynamically allocate 
file sizes, it is important to create a page image file of sufficient 
size. Because page image posting is not meaningful in multiuser 
situations, it is available only for the single user version of MDBS. 
The PIFD, TRBGN, TRCOM and TRABT commands are described in Chapter XVI 
and in the MDBS RTL Manual. 

Selective Rollback . The foregoing mechanisms do not help in the 
event of a hardware failure that physically destroys a portion of the 
data base. In this case the RTL transaction logging and recovery 
facilities are used to restore the data base. The DML commands for 
utilizing automatic transaction logging within a run unit are 
presented in Chapter XVI. The transaction log file (defined in the 
DDL specification) is distinct from the page-image file. Either, 
both, or neither can be used by a run unit. In the event of any type 
of inconsistency in the data base (due to abnormal termination, 
hardware failure, incorrect data entry, etc.) the transaction log file 
can automatically be applied to a data base back-up copy by using the 
RTL recovery utility (RCV) . This recovery can be selective if 
desired, so that only certain logged transactions are used to recover. 
Bad transactions (e.g., incorrect data entry) can be discarded during 
the selective rollback. 

Full details about the MDBS recovery facilities available with 
the RTL form of MDBS, including its use for surveillance of users' 
activities, are presented in the MDBS RTL Manual. 
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III. FIND COMMANDS 


A. Overview 

The MDBS Data Manipulation Language supports twenty-four find 
commands, providing an application programmer with many ways to find a 
given record. The principal objective of any find command is to make 
a record the current owner of a set, the current member of a set, the 
current of the run unit, or some combination of these. The found 
record becomes one of the records that the application program is 
currently interested in; as soon as a record becomes current, it can 
be processed in various ways by other DML commands. The find commands 
fall into four main groups: 

1. Find a member record that is related to a given owner 
record via some set: 

find the first member, 
next member, 
last member, 
prior member, 

member with a particular sort key value, 
member with a particular value for some data item, 
member with the same value for a data item or sort 
key as an already found member. 

Which member is first, next, last, or prior depends on the 
set's member order specified in the DDL. If the member 
order is sorted, members can quickly be found on the basis 
of their sort key values. 

2. Find an owner record that is related to a given member 
record via some set: 

find the first owner, 
next owner, 
last owner, 
prior owner, 

owner with a particular sort key value, 
owner with a particular value for some data item, 
owner with the same value for a data item or sort 
key as an already found owner. 

Which owner is first, next, last, or prior depends on the 
set's owner order specified in the DDL. If the owner order 
is sorted, owners can quickly be found on the basis of their 
sort key values. 


(C) COPYRIGHT 1981 Micro Data Base Systems, Inc. 


Rev. 85A 11 



MDBS DMS MANUAL 


III: FIND COMMANDS 


MDBS DM S MANUAL 


3. If a record type was declared in the DDL to have a calc key, 
then any of its records can be found "out of the blue," 
without reference to any set in which the record type 
participates. MDBS. DMS finds the desired record on the 
basis of a calc key value furnished by the application 
program. If 'duplicate calc keys are allowed, then all 
records with the same calc key value can be found. 


4. The application program can sequentially find the records in 
a desired area or areas. This refers to the physical 
sequence of records. 

If a find command returns a command status of zero, then the 
desired record was found. If the command status is 255, then the 
record requested through a find command does not exist in the data 
base. The branching and control structure of a host language program 
is typically based quite heavily on the command status returned by the 
various find commands used in the program. 


Data security conditions, as defined in a DDL schema 
specification, are automatically enforced when a find command is 
invoked. If the user of an application program attempts to perform a 
"find" that is inconsistent with the user's read access codes, a 
command status will result which indicates that the find was not 
performed. 


B. Command Details 




£ind duplicate Record based on calc J£ey 




Command and Arguments 
FDRK, rec, iblk 
Currency Indicators 

Used : CRU Changed : CRU -e -record having duplicate 

calc key value 


Description 

If the current oL run unit is not mil w.fafin H2RK is i nv.Q -keti: 
Find an occurrence of the same record type as the current of run 
unit, and having a calc key value that matches the calc key value 
held in iblk's variable (s). If such a record is found, it 
becomes the new current of run unit. This command is valid only 
if the record that is the current of run unit is an occurrence of 
rec and rec has been defined (in the DDL) as having a calc key. 
The calc key value indicated by iblk must duplicate the calc key 
value of the current of run unit, otherwise a command status 
error results (the current of run unit is not altered) . 


12 


(C) COPYRIGHT 1981 Micro Data Base Systems, Inc. 


MDBS DMS MANUAL 


III: FIND COMMANDS 


MDBS DMS MANUAL 


Use of FRK, followed by repeated use of FDRK, will find all 
records of a given record type having the same calc key value. 
The order in which these are found is not guaranteed. If an FDRK 
command is given when there are no more duplicates of a 
particular calc key value, then the current of run unit becomes 
null and the command status is 255. If a user does not have read 
access to all data items that form the calc key, then a command 
status error is returned. 


If fhfi cf run unit is null xhsin £D£K is inszcked: fdrk 

has exactly the same effect as FRK. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= FDRK ( "rec, iblk") 

= DMS ("FDRK, rec, iblk") 

= FDRK ("rec", iblk) 

= DMSD ("FDRK, rec", iblk) 


FFM find first Member FFM 

Command and Arguments 
FFM, set-1 

Currency Indicators 

Used: CO (set-1) Changed: CM (set-1) <£ first member (set-1) 

CRU < first member (set-1) 


Description 

The first member connected to the current owner of set-1 becomes 
the current member of set-1 and the current of the run unit. 
Which member is first depends on the set-1 member order, as 
specified with the DDL. If the current owner of set-1 has no 
member, then the command status is 255 , the current of run unit 
becomes null, and the current member of set-1 is null. If a user 
does not have read access to set-1, then a command status error 
is returned. 


Examples of Command Usage 


block/direct 
block/indirect ... 
record/direct 
record/indirect. . . 


EO 

= FFM 

("set-1") 

EO 

= DMS 

("FFM, set-1") 

EO 

= FFM 

("set-1") 

EO 

= DMS 

( "FFM, set-1") 
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Eind Eirst Qwner 


EEQ 


Command and Arguments 
FFO, set-1 

Currency Indicators 

U££d: CM (set-1) Changed: CO (set-1 ) < first owner (set-1) 

CRU < first owner (set-1) 

Description 

The first owner connected to the current member of set-1 becomes 
the current owner of set-1 and the current of the run unit. 
Which owner is first depends on the set-1 owner order, as 
specified with the DDL. If the current member of set-1 has no 
owner, then the command status is 255, the current of run unit is 
null, and the current owner of set-1 is null. If a user does not 
have read access to set-1, then a command status error is 
returned. 

Examples of Command Usage 


block/direct 

EO 

= FFO 

( "set- 

-1") 

block/indirect . . . 

EO 

■ DMS 

( "FFO, 

, set-1") 

record/direct 

EO 

= FFO 

( "set- 

-1") 

record/indirect. . . 

EO 

= DMS 

( "FFO, 

- set-1 ") 


FFS Eind Eirst Sequential record FFS 


Command and Arguments 

FFS, area (the area argument is optional) 

Currency Indicators 

record in area 


the indicated area 
becomes the current of run unit. If the indicated area has no 
records, then current of run unit becomes null and the command 
status is 255. When the area argument is omitted, FFS operates 
on the main area and then on all subsequent areas until a record 
is found (i.e., the main area may have no data records). 

FFS allows a user with any access code to find the physically 
first record of an area regardless of the access codes of that 
record's record type. However, the user will be unable to 


Used: none 


Changed: cru«- 


•f irst 


Description 

The record that 


is physically first within 
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retrieve data from the found record or modify its data unless the 
user's access authorization permits read or write access to 
occurrences of the record type. 

Examples of Command Usage 


block/direct ... EO 

= FFS 

( "area") 

or 

EO 

= FFS 

(" 

") 

block/indirect ... EO 

= DMS 

( "FFS, area") 

or 

EO 

= DMS 

("FFS") 

record/direct ... EO 

= FFS 

( "area") 

or 

EO 

= FFS 

(" 

") 

record/indirect... EO 

= DMS 

("FFS, area") 

or 

EO 

= DM S 

( "FFS") 


FLM Eind Last Member ELM 

Command and Arguments 
FLM, set-1 

Currency Indicators 

Used: CO (set-1) Changed: CM (set-1) < last member (set-1) 

CRU < last member (set-1) 


Description 

The last member connected to the current owner of set-1 becomes 
the current member of set-1 and the current of the run unit. 
Which member is last depends on the set-1 member order, as 
specified with the DDL. If the current owner of set-1 has no 
member, then the command status is 255 , the current of run unit 
becomes null and the current member of set-1 becomes null. If a 
user does not have read access to set-1, then a command status 
error is returned. 

Examples of Command Usage 


block/direct 

EO 

= FLM 

( "set- 

-1") 

block/indirect ... 

EO 

= DMS 

( "FLM, 

•set-1") 

record/direct 

EO 

= FLM 

( "set- 

-1") 

record/indirect. . . 

EO 

= DMS 

( "FLM, 

• set-1 " ) 


FLO Eind Last Qwner FLO 

Command and Arguments 
FLO, set-1 

Currency Indicators 

Caad: CM (set-1) Changed: CO (set-1) < last owner (set-1) 

CRU < last owner (set-1) 


(C) COPYRIGHT 1981 Micro Data Base Systems, Inc 


15 


MDBS DMS MANUAL 


Ills FIND COMMANDS 


MDBS DMS MANUAL 


Description 

The last owner connected to the current member of set-1 becomes 
the current owner of set-1 and the current of the run unit. 
Which owner is last depends on the set-1 owner order, as 
specified with the DDL. If the current member of set-1 has no 
owner, then the command status is 255, the current of run unit 
becomes null, and the current owner of set-1 becomes null. If a 
user does not have read access to set-1, then a command status 
error is returned. 

Examples of Command Usage 

block/direct ... EO = FLO ("set-1") 
block/indirect ... EO = DMS ( "FLO, set-1 " ) 
record/direct ... EO = FLO ("set-1") 
record/indirect... EO = DMS ( "FLO, set-1") 


FMI find Member based on data Item FMI 


Command and Arguments 

FMI , item, set-1 , iblk 
Currency Indicators 

Ufifid: CO (set-1) Changed: CM (set-1) first member (set-1) 

CRU ^ having data item value 

Description 

The first member record connected to the current owner of set-1, 
and having a value for itm that matches the value of iblk, 
becomes the current member of set-1. It also becomes the current 
of run unit. If there are two or more member records for the 
current owner of set-1, all having the iblk value for itm, which 
one is first depends on the set-1 member order. The command FNMI 
can be used to find the next member having the same iblk value 
for itm. 

The host language variable of iblk must be consistent in size and 
type with the itm data item (as specified in the DDL). If the 
value of iblk's host language variable does not match the itm 
value of any member record connected to the current owner of set- 
1, then the command status is 255, the current member of set-1 
becomes null, and the current of run unit becomes null. A 
command status error is returned if a user does not have read 
access to both itm and set-1. 
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Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


FMI ("itm, set-1, iblk") 

DMS ("FMI, itm, set-1, iblk") 
FMI ( "itm, set-1 ", iblk) 

DMSD ("FMI, itm, set-1", iblk) 


EHSK 


Find Member based on Sort Key 


EESL 


Command and Arguments 
FMSK, set-1, iblk 
Currency Indicators 

USfid: CO (set-1) Changed: CM (set-1) first member (set-1) 

CRU ^ having sort key value 


Description 

The first member record that has the sort key value of iblk and 
that is connected to the current owner of set-1 becomes the 
current member of set-1. It also becomes the current of the run 
unit. Set-1 must have a sorted member order. 

If several member records for the current owner of set-1 have the 
same sort key value, the one that is first depends on the DDL 
sort-clause specification for the set-1 member order (either 
LIFO, FIFO, or IMMATERIAL). The host language variable(s) of 
iblk must contain the desired sort key value. If there are 
multiple data items for the set-1 sort key, the sort key value 
for iblk must be consistent with the sequence, types and sizes of 
the data items in the DDL sort key specification. If RECORD-TYPE 
is part of the sort key, then the name of the desired record type 
must appear as part of the iblk sort key value; the host language 
variable holding the record type name must be consistent with a 
string data item of 8 bytes in size. 

If the current owner of the set-1 has no member whose sort key 
value matches the sort key value of iblk, then the command status 
is 255. The member whose sort key value immediately follows the 
iblk sort key value becomes the current member of set-1, as well 
as the current of run unit. The exceptions are when the current 
owner of set-1 has no members or when iblk's sort key value is 
greater than the sort key value of the last member of set-l's 
current owner. In these cases, the current member of set-1 
becomes null and the current of run unit becomes null. 

A command status error is returned if a user does not have read 
access to set-1 and all data items that make up the member sort 
key. 
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Examples of Command Usage 


block/direct 

EO 

= FMSK 

block/indirect ... 

EO 

= DMS 

record/direct ... 

EO 

= FMSK 

record/indirect. . . 

EO 

= DMSD 


EHH find Next 

Command and Arguments 
FNM, set-1 

Currency Indicators 

Used : CO (set-i) Cbansed: 

CM (set-1) 


set-1, iblk") 

FMSK, set-1, iblk") 
set-1" , iblk) 

FMSK, set-1", iblk) 


Member FNM 


CM (set-1) < next member (set-1) 

CRU < next member (set-1) 


Description 

It the current member Ql seirl is net null when EMM is inseked: 
The next member record (connected to the current owner of set-1) 
following the current member of set-1 becomes the new current 
member of set-1. It also becomes the current of run unit. Which 
member record is logically next depends on the set-1 member 
order, as specified with the DDL. If the current member of set-1 
is the last member for the current owner of set-1, then FNM 
cannot find a next member. When there is no next member for the 
current owner of set-1, the command status is 255, the current 
member of set-1 becomes null, and the current of run unit becomes 
null. A command status error is returned if a user does not have 
read access to set-1. 

It the current member Qt setrl is null when EMM is inxeked: fnm 

has exactly the same effect as FFM. 

Examples of Command Usage 


block/direct 

EO 

= FNM 

( "set- 

-1") 

block/indirect ... 

EO 

= DMS 

("FNM, 

. set-1 " ) 

record/direct 

EO 

= FNM 

( "set- 

-1") 

record/ indirect . . . 

EO 

= DMS 

( "FNM, 

, set-1") 
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Find Next Member based on data item 




Command and Arguments 

FNMI, itm, set-1 , iblk 
Currency Indicators 

Used : CO (set-1) Changed : CM (set-1) ^ next member (set-1) 

CM (set-1) CRU with item value 

Description 

If the current member of set-1 is not null when FNMI is invoked : 
The next member record connected to the current owner of set-1, 
and having a value for itm that matches the value of iblk, 
becomes the current member of set-1. It also becomes the current 
of run unit. The host language variable of iblk must be 
consistent in size and type with the itm data item (as specified 
in the DDL) . If there are two or more member records following 

the current member of set-1, all having the iblk value for itm, 
which one is next depends on the set-1 member order. If such a 
record does not exist, the command status is 255, the current 
member of set-1 becomes null, and the current of run unit becomes 
null. If a user does not have read access to both itm and set-1, 
then a command status error is returned. 

If t*i£ .c u rr en t jnemtigr sf setrl Is mil xhen zmi is iny Q&sd ; 
FNMI has exactly the same effect as FMI . The first member record 
connected to the current owner of set-1, and having a value for 
itm that matches the value of iblk, becomes the current member of 

set-1 . 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/ indirect. . . EO 


= FNMI (" itm, set-1 , iblk " ) 

= DMS ("FNMI, itm, set-1, iblk") 

« FNMI ("itm, set-1", iblk) 

- DMSD ("FNMI, itm, set-1", iblk) 


ZNMSK Zind Uext Member based on £ort £ey fnmsk 

Command and Arguments 
FNMSK, set-1, iblk 
Currency Indicators 

Used: CO (set-1) Changed : CM (set-1) [next member 

CM (set-1) CRU ** (set-1) having 

sort key value 
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Description 

The next member record (after the current member) that has the 
sort key value of iblk and that is connected to the current owner 
of set-1 becomes the current member of set-1. It also becomes 
the current of the run unit. Set-1 must have a sorted member 
order. 

If set-1 has no current member, then FNMSK behaves just as FMSK. 
If several member records for the current owner of set-1 have the 
same sort key value, the one that is next depends on the DDL 
sort-clause specification for the set-1 member order (either 
LIFO, FIFO, or IMMATERIAL). The host language variable (s) of 
iblk must contain the desired sort key value. If there are 
multiple data items for the set-1 sort key, the sort key value 
for iblk must be consistent with the sequence, types and sizes of 
the data items in the DDL sort key specification. If RECORD-TYPE 
is part of the sort key, then the name of the desired record type 
must appear as part of the iblk sort key value; the host language 
variable holding the record type name must be consistent with a 
string data item of 8 bytes in size*, 

If the current owner of the set-1 has no member (after the 
current member) whose sort key value matches the sort key value 
of iblk, then the command status is 255. The next member 
immediately following the current member becomes the current 
member of set-1, as well as the current of run unit. The 
exceptions are when the current owner of set-1 has no members or 
when iblk's sort key value is greater than the sort key value of 
the last member of set-1 ' s current owner. In these cases, the 
current member of set-1 becomes null and the current of run unit 
becomes null. 


A command status error is returned if a user does not have read 
access to set-1 and all data items that make up the member sort 
key. 


Examples ot Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/ indirect. . . EO 


= FNMSK ("set-1, iblk") 

= DMS ("FNMSK, set-1, iblk") 
= FNMSK ("set-1", iblk) 

= DMSD ("FNMSK, set-1", iblk) 


FNQ £ind Uext Qwner FNQ 

Command and Arguments 
FNO, set-1 

Currency Indicators 

Used : CM (set-1) Changed : CO (set-1) < next owner (set-1) 

CO (set-1) CRU < next owner (set-1) 
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Description ... 

If the current owner of set-1 is not null whe n is invok e d : 

The next owner record (connected to the current member of set-1) 
following the current owner of set-1 becomes the new current 
owner of set-1. It also becomes the current of run unit. Which 
owner record is logically next depends on the set-1 owner order, 
as specified with the DDL. If the current owner of set-1 is the 
last owner for the current member of set-1, then FNO cannot find 
a next owner. When there is no next owner for the current member 
of set-1, the command status is 255, the current owner of set-1 
becomes null, and the current of run unit becomes null. A 
command status error is returned if a user does not have read 
access to set-1. 

If the current owner of set-1 is null when £N£> is invoked: FNO 

has exactly the same effect as FFO. 

Examples of Command Usage 


block/direct 

EO 

= FNO 

("set- 

•1") 

block/indirect ... 

EO 

= DMS 

( "FNO, 

set-1") 

record/direct ... 

EO 

= FNO 

("set- 

■1") 

record/indirect. . . 

EO 

= DMS 

( "FNO, 

set-1" ) 


FNO I £ind Uext jQwner based on data item £NQX 


Command and Arguments 

FNOI , itm, set-1 , iblk 
Currency Indicators 

Used : CM (set-1) Changed : CO(set-l)^ next owner (set-1) 

CO (set-1) CRU with item value 

Description 

11 ike sue. r snt ownei si aet-i is noi null wJbsn FUQI is i nvoked: 
The next owner record connected to the current member of set-1, 
and having a value for itm that matches the value of iblk, 
becomes the current owner of set-1. It also becomes the current 
of run unit. The host language variable of iblk must be 
consistent in size and type with the itm data item (as specified 
in the DDL) . If there are two or more owner records following 
the current owner of set-1, all having the iblk value for itm, 
which one is next depends on the set-1 owner order. If such a 
record does not exist, the command status is 255, the current 
owner of set-1 becomes null, and the current of run unit becomes 
null. If a user does not have read access to both itm and set-1, 
then a command status error is returned. 
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.11 the, CUICSnt owner set-1 is null when FNOI is invoked ; FNOI 
has exactly the same effect as FOI. The first owner record 
connected to the current member of set-1, and having a value for 
itm that matches the value of iblk, becomes the current owner of 

set-1. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= FNOI ("itm, set-1, iblk") 

= DMS ("FNOI, itm, set-1, iblk") 
= FNOI ("itm, set-1", iblk) 

= DMS ("FNOI, itm, set-1", iblk) 


FNQSK £ind Uext Qwner based on £ort £ey FNOSK 

Command and Arguments 
FNOSK, set-1, iblk 
Currency Indicators 

Used : CO (set-1) Changed : CO (set-1) 

CM (set-1) CRU 


next owner (set-1) 
having sort key 
value' 


Description 

The next owner record (after the current owner) that has the sort 
key value of iblk and that is connected to the current member of 
set-1 becomes the current owner of set-1. It also becomes the 
current of the run unit. Set-1 must have a sorted owner order. 

If set-1 has no current owner, then FNOSK behaves just as FOSK. 
If several owner records for the current member of set-1 have the 
same sort key value, the one that is next depends on the DDL 
sort-clause specification for the set-1 owner order (either LIFO, 
FIFO, or IMMATERIAL). The host language variable (s) of iblk must 
contain the desired sort key value. If there are multiple data 
items for the set-1 sort key, the sort key value for iblk must be 
consistent with the sequence, types and sizes of the data items 
in the DDL sort key specification. If RECORD-TYPE is part of the 
sort key, then the name of the desired record type must appear as 
part of the iblk sort key value; the host language variable 
holding the record type name must be consistent with a string 
data item of 8 bytes in size. 

If the current member of the set-1 has no owner (after the 
current owner) whose sort key value matches the sort key value of 
iblk, then the command status is 255. The next owner immediately 
following the current member becomes the current owner of set-1, 
as well as the current of run unit. The exceptions are when the 
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current member of set— 1 has no owners or when iblk's sort key 
value is greater than the sort key value of the last owner of 
set-1' s current member. In these cases, the current owner of 
set-1 becomes null and the current of run unit becomes null. 

A command status error is returned if a user does not have read 
access to set-1 and all data items that make up the owner sort 
key. 


Examples of Command Usage 


block/direct 
block/indirect . . . 
record/direct 
record/indirect. . . 


EO 

= FNOSK 

("set-1 

EO 

= DMS ( 

"FNOSK, 

EO 

= FNOSK 

("set-1 

EO 

= DMSD ( 

"FNOSK, 


, iblk") 
set-1 , iblk " ) 
" , iblk) 
set-1", iblk) 


FNS find Next Sequential record FNS 

Command and Arguments 

FNS, area (the area argument is optional) 

Currency Indicators 

Used: CRU Chansfid: CRU« next record in area 

Description 

The record that is physically next after the current of run unit 
within the indicated area becomes the current of run unit. A 
command status error is issued if the current of run unit is not 
in the indicated area; the current of run unit is not changed. 

If the current of run unit is the physically last record in an 
area when FNS is invoked, then FNS will give a command status of 
255 and the current of run unit is unchanged. If an area name is 
not indicated, then FNS will not give a 255 command status at the 
end of an area. It will proceed to make the physically first 
record of the next area the current of run unit. The sequence of 
areas is determined by the order in which areas are defined in 
the DDL area section. The main area is always the first area. 
If the current of run unit is the last record in the last area, 
invoking FNS will give a 255 command status and leave the current 
of run unit null. 

FNS allows a user with any access code to find the physically 
next record of an area regardless of the access codes of that 
record's record type. However, the user will be unable to 
retrieve data from the found record or modify its data unless the 
user's access authorization permits read or write access to 
occurrences of the record type. - 


(C) COPYRIGHT 1981 


Micro Data Base Systems, 


Inc 


23 


MDBS DMS MANUAL 


III: FIND COMMANDS 


MDBS DMS MANUAL 


Examples of Command Usage 

block/direct ... EO = FNS ("area") or EO = FNS (" ") 
block/indirect ... EO = DMS ("FNS, area") or EO = DMS ("FNS") 
record/direct ... EO = FNS ("area") or EO = FNS ( B ") 
record/indirect... EO = DMS ("FNS, area") or EO = DMS ("FNS") 


FQI £ind Qwner based on data Item FOI 


Command and Arguments 

FOI , item, set-1 , iblk 
Currency Indicators 

Hfifid: CM(set-l) Ciiansfid: CO(set-l) sS first owner(set-l) 

CRU having data item value 

Description 

The first owner record connected to the current member of set-1, 
and having a value for itm that matches the value of iblk, 
becomes the current owner of set-1. It also becomes the current 
of run unit. If there are two or more owner records for the 
current member of set-1, all having the iblk value for itm, which 
one is first depends on the set-1 owner order. The command FNOI 
can be used to find the next owner having the same iblk value for 
itm. 

The host language variable of iblk must be consistent in size and 
type with the itm data item (as specified in the DDL). If the 
value of iblk's host language variable does not match the itm 
value of any owner record connected to the current member of set- 
1, then the command status is 255, the current owner of set-1 
becomes null, and the current of run unit becomes null. A 
command status error is returned if a user does not have read 
access to both itm and set-1. 

Examples of Command Usage 

block/direct ... EO = FOI ( "itm, set-1 , iblk") 
block/indirect ... EO = DMS ( "FOI, itm, set-1 , iblk") 
record/direct ... EO = FOI ( "itm, set-1 ", iblk) 
record/indirect... EO = DMSD ( "FOI, itm, set-1 ", iblk) 
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FQSK 


£ind Qynev based on £ort £ey 


FOS* 


Command and Arguments 
FOSK, set-1, iblk 

Currency Indicators 

Used : CM (set-1) Changed : CO (set-1) first owner (set-1) 

CRU ^ having sort key value 

Description 

The first owner record that has the sort key value of iblk and 
that is connected to the current member of set-1 becomes the 
current owner of set-1. It also becomes the current of the run 
unit. Set-1 must have a sorted owner order. 

If several owner records for the current member of set-1 have the 
same sort key value, the one that is first depends on the DDL 
sort-clause specification for the set-1 owner order (either LIFO, 
FIFO, or IMMATERIAL). The host language variable (s) of iblk must 
contain the desired sort key value. If there are multiple data 
items for the set-1 sort key, the sort key value for iblk must be 
consistent with the sequence, types and sizes of the data items 
in the DDL sort key specification. If RECORD-TYPE is part of the 
sort key, then the name of the desired record type must appear as 
part of the iblk sort key value; the host language variable 
holding the record type name must be consistent with a string 
data item of 8 bytes in size. 

If the current member of the set-1 has no owner whose sort key 
value matches the sort key value of iblk, then the command status 
is 255. The owner whose sort key value immediately follows the 
iblk sort key value becomes the current owner of set-1, as well 
as the current of run unit. The exceptions are when the current 
member of set-1 has no owners or when iblk's sort key value is 
greater than the sort key value of the last owner of set-1' s 
current member. In these cases, the current owner of set-1 
becomes null and the current of run unit becomes null. 


A command status error is returned if a user does not have read 
access to set-1 and all data items that make up the owner sort 
key. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= FOSK ("set-1, iblk") 

= DMS ("FOSK, set-1, iblk") 
= FOSK ("set-1", iblk) 

= DMSD ("FOSK, set-1", iblk) 
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FPM £ind prior Member FPM 

Command and Arguments 
FPM, set-1 


Currency Indicators 

Used : CO (set-1) Changed : CM (set-1) < prior member (set-1) 

CM (set-1) CRU < prior member (set-1) 

Description 

11 the. fi.ti.rxe, lit member ol aet r l Is. net null when ppm in invoked : 
The prior member record (connected to the current owner of set-1) 
preceding the current member of set-1 becomes the new current 
member of set-1. It also becomes the current of run unit. Which 
member record is logically prior depends on the set-1 member 
order, as specified with the DDL. If the current member of set-1 
is the first member for the current owner of set-1, then FPM 
cannot find a prior member. When there is no prior member for 
the current owner of set-1, the command status is 255, the 
current member of set-1 becomes null, and the current of run unit 
becomes null. A command status error is returned if a user does 
not have read access to set-1. 

11 iks current member ol fi,e t- .l Is null M-hen £EM Is invcksti: fpm 

has exactly the same effect as FLM. 

Examples of Command Usage 


block/direct 

EO 

= FPM 

( "set- 

1") 

block/indirect ... 

EO 

= DMS 

( "FPM, 

set-1") 

record/direct 

EO 

■ FPM 

("set- 

1") 

record/indirect. . . 

EO 

= DMS 

( "FPM, 

set-1" ) 


fpmi £ind Prior pember based on data Item FPMI 

Command and Arguments 

FPMI, itm, set-1, iblk 
Currency Indicators 

Used : CO (set-1) Changed : CM (set- 1) __ prior member (set-1) 

CM (set-1) CRU 4 with item value 
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Description 

If the current member of set-1 is not null when FP.MI is invoked: 
The prior member record connected to the current owner of set-1 , 
and having a value for itm that matches the value of iblk, 
becomes the current member of set-1. It also becomes the current 
of run unit. The host language variable of iblk must be 
consistent in size and type with the itm data item (as specified 
in the DDL) . If there are two or more member records preceding 
the current member of set-1, all having the iblk value for itm, 
which one is prior depends on the set-1 member order. If such a 
record does not exist, the command status is 255, the current 
member of set-1 becomes null, and the current of run unit becomes 
null. If a user does not have read access to both itm and set-1, 
then a command status error is returned. 


11 the. gujjLftnt Bi. e Elb.SJ. nl set-1 Is null whe n £2MI Is invoked : The 
last member record connected to the current owner of set-1, and 
having a value for itm that matches the value of iblk, becomes 
the current member of set-1. 


Examples of Command Usage 


block/direct ... 

EO 

= FPMI 

block/indirect . . . 

EO 

= DMS 

record/direct ... 

EO 

= FPMI 

record/ indirect. . . 

EO 

= DMSD 


FPMSK £ind £rior Member 


("itm,set-l, iblk") 
"FPMI, itm, set-1 , iblk" ) 
("itm, set-1" , iblk) 

( "FPMI, itm, set-1" , iblk) 


based on £ort £ey FPMSK 


Command and Arguments 
FPMSK, set-1, iblk 
Currency Indicators 

.U-ged : CO (set-1) Changed : CM (set-1) prior member 

CM (set-1) CRU < (set-1) having 

sort key value 

Description 

Set-1 must have a sorted member order. The prior member record 
(after the current member) that has the sort key value of iblk 
and that is connected to the current owner of set-1 becomes the 
current member of set-1. It also becomes the current of the run 
unit. If set-1 has no current member, then the last member 
having the sort key value is found. If several member records 
for the current owner of set-1 have the same sort key value, the 
one that is prior depends on the DDL sort-clause specification 
for the set-1 member order (either LIFO, FIFO, or IMMATERIAL) . 
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The host language variable (s) of iblk must contain the desired 
sort key value. If there are multiple data items for the set-1 
sort key, the sort key value for iblk must be consistent with the 
sequence, types and sizes of the data items in the DDL sort key 
specification. If RECORD-TYPE is part of the sort key, then the 
name of the desired record type must appear as part of the iblk 
sort key value; the host language variable holding the record 
type name must be consistent with a string data item of 8 bytes 
in size. 


If the current owner of the set-1 has no member (before the 
current member) whose sort key value matches the sort key value 
of iblk, then the command status is 255. The member immediately 
preceding the current member becomes the current member of set-1, 
as well as the current of run unit. The exceptions are when the 
current owner of set-1 has no members or when iblk's sort key 
value is lower than the sort key value of the first member of 
set-1 's current owner. In these cases, the current member of 
set-1 becomes null and the current of run unit becomes null. 


A command status error is returned if a user does not have read 
access to set-1 and all data items that make up the member sort 
key. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= FPMSK ("set-1, iblk") 

= DMS ("FPMSK, set-1, iblk”) 

= FPMSK ("set-1", iblk) 

= DMSD ("FPMSK, set-1", iblk) 


fpq £ind £rior £wner FPQ 

Command and Arguments 
FPO, set-1 

Currency Indicators 

Used : CM(set-l) Changed : CO (set-1 ) < prior owner (set-1) 

CO (set-1) CRU < prior owner (set-1) 

Description 

If the current owner ot set-1 is not null when FPQ is i nv oked: 
The prior owner record (connected to the current member of set-1) 
preceding the current owner of set-1 becomes the new current 
owner of set-1. It also becomes the current of run unit. Which 
owner record is logically prior depends on the set-1 owner order, 
as specified with the DDL. If the current owner of set-1 is the 
first owner for the current member of set-1, then FPO cannot find 
a prior owner. when there is no prior owner for the current 
member of set-1, the command status is 255, the current owner of 
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set-1 becomes null, and the current of run unit becomes null. A 
command status error is returned if a user does not have read 
access to set-1. 


If the current owner oL set-1 is null when ,FPQ i£ iPVPke.ci? 
has exactly the same effect as FLO. 


Examples of Command usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


FPO ("set-l" ) 

DMS ("FPO, set-1") 
FPO ("set-1") 

DMS ("FPO, set-1") 


FPQI 


£ind prior Owner based on data Item 


Command and Arguments 

FPO I, itm, set-1 , iblk 
Currency Indicators 

prior owner (set-1) 
with item value 

Description 

if the current ownex M set-l is not null whsc FPQ.I is invoked? 
The prior owner record connected to the current member of set-l, 
and having a value for itm that matches the value of iblk, 
becomes the current owner of set-l. It also becomes the current 
of run unit. The host language variable of iblk must be 
consistent in size and type with the itm data item (as specified 
in the DDL) . If there are two or more owner records preceding 
the current owner of set-l, all having the iblk value for itm, 
which one is prior depends on the set-l owner order. If such a 
record does not exist, the command status is 255, the current 
owner of set-l becomes null, and the current of run unit becomes 
null. If a user does not have read access to both itm and set-l, 
then a command status error is returned. 

If the current o wner x£ set-l Is null when Z201 is. il?VQ.kjed: The 

last owner record connected to the current member of set-l, and 
having a value for itm that matches the value of iblk, becomes 
the current owner of set-l. 


Used : 


CM (set-l) 
CO (set-l) 


Changed : 


CO (set-l) 
CRU 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/ indirect. . . EO 


= FPO I ("itm, set-l, iblk") 

= DMS ( "FPOI, itm, set-l , iblk" ) 
= FPOI ("itm, set-l", iblk) 

= DMS ("FPOI, itm, set-l", iblk) 
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FPOSK £ind Prior £wner based on Port Key FPOSK 


Command and Arguments 
FPOSK, set-1, iblk 

Currency Indicators 

Used : CO (set-1) Changed : CO (set-1) [prior owner (set-1) 

CM (set-1) CRU ^ having sort key 

_value 

Description 

Set-1 must have a sorted owner order. The prior owner record 
(before the current owner) that has the sort key value of iblk 
and that is connected to the current member of set-1 becomes the 
current owner of set-1. It also becomes the current of the run 
unit. If set-1 has no current owner, then the last owner having 
the sort key value is found. If several owner records for the 
current member of set-1 have the same sort key value, the one 
that is prior depends on the DDL sort-clause specification for 
the set-1 owner order (either LIFO, FIFO, or IMMATERIAL) . 

The host language variable (s) of iblk must contain the desired 
sort key value. If there are multiple data items for the set-1 
sort key, the sort key value for iblk must be consistent with the 
sequence, types and sizes of the data items in the DDL sort key 
specification. If RECORD-TYPE is part of the sort key, then the 
name of the desired record type must appear as part of the iblk 
sort key value; the host language variable holding the record 
type name must be consistent with a string data item of 8 bytes 
in size. 

If the current member of the set-1 has no owner (before the 
current owner) whose sort key value matches the sort key value of 
iblk, then the command status is 255. The owner immediately 
preceding the current owner becomes the current owner of set-1, 
as well as the current of run unit. The exceptions are when the 
current member of set-1 has no owners or when iblk’s sort key 
value is less than the sort key value of the first owner of set- 
l's current member. In these cases, the current owner of set-1 
becomes null and the current of run unit becomes null. 

A command status error is returned if a user does not have read 
access to set-1 and all data items that make up the owner sort 
key. 

Examples of Command Usage 

block/direct ... EO = FPOSK (" set-1 , iblk" ) 
block/indirect ... EO = DMS ("FPOSK, set-1 , iblk" ) 
record/direct ... EO = FPOSK (" set-1" , iblk) 
record/indirect... EO = DMSD ( "FPOSK, set-1" , iblk) 
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EBK 


£ind Eecord based on calc J£ey 




Command Arguments 
FRK, rec, iblk 
Currency Indicators 

Used : none Changed : CRU< record having calc 

key value 


Description 

Find the occurrence of the indicated record type (rec) whose calc 
key has a value that matches the value of iblk's host language 
variable (s). If such an occurrence is found, it becomes the 
current of run unit. This command is valid only if rec has a 
calc key clause in the DDL specification. Occurrences of rec 
with duplicate calc key values may exist in the data base, if the 
DDL specification declares that duplicates are allowed. If there 
is more than one occurrence of rec whose calc key value matches 
the iblk value, then FRK finds one of these duplicates and FDRK 
can be used repeatedly to find each of the other duplicates. 


The sequence, size and type of iblk's host language variables 
must be consistent with the sequence, size and type of data items 
that make up the calc key for rec. If the iblk value does not 
match the calc key value for any occurrence of the rec record 
type, then the command status is 255 and CRU becomes null. A 
command status error is returned if a user does not have read 
access to all data items that make up rec's calc key. 


Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


FRK ("rec, iblk") 

DMS ("FRK, rec, iblk") 
FRK ("rec", iblk) 

DMSD ("FRK, rec", iblk) 
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IV. RETRIEVAL COMMANDS 

A. Overview 

The MDBS Data Manipulation Language supports twenty-eight data 
retrieval commands. Each retrieval command has the effect of 
transferring data from a record to a host language variable (s) through 
the mechanism of a data block (or program record type) . There are two 
major groups of retrieval commands: those that get data from a 

current record and those that obtain data from a record that may not 
have previously been current. 

The first group is intended for situations where data need to be 
retrieved from a previously found record that is presently the current 
owner of a set, the current member of a set, or the current of run 
unit. This group of retrieval commands is composed of two subgroups. 

1. Get the values of all data items (i.e., fields) from the record 
that is the current owner of an indicated set, the current member 
of an indicated set, or the current of run unit. These values 
are deposited in the host language variable (s) of a specified 
data block. 

2. Get the value of a particular data item (i.e., field) from the 
record that is the current owner of an indicated set, the current 
member of an indicated set, or the current of run unit. This 
data value is deposited in the host language variable of a 
specified data block. Commands in this subgroup should be used 
where maximum data independence is desired. 

The second major group of retrieval commands is intended for 

situations where data needs to be retrieved from a record that is not 

presently current. Each of these commands obtains a desired record by 
first making it the current owner of an indicated set, the current 
member of an indicated set, and/or the current of run unit. Then the 
values of all data items from that record are deposited in the host 
language variable (s) of a specified data block. This retrieval 

approach can result in faster processing than using a find command 
followed by a command to get data from the found record, particularly 
in multiuser environments. 

For either retrieval approach, it is vital that the host language 
variable (s) receiving retrieved data is consistent with the type and 
size of the data item(s). Each data value is converted from the 

internal MDBS form for the data item type into the consistent host 

language form. If a host language variable is of insufficient size to 

hold the entire stored data value, a command status error results. 
However, MDBS. DMS does attempt to return as much of the data value as 
possible into the host language variable. Where all data values of a 
record are being retrieved at once, the host language variables 

defined for the receiving data block must also conform with the 

sequence of data items as defined for that record's type in the DDL. 

Data security conditions, as defined in a DDL schema 
specification, are automatically enforced when a retrieval command is 
invoked. If the user of an application program attempts to perform a 
retrieval that is inconsistent with that user's read access codes, a 
command status will result which indicates that the retrieval was not 
performed. 

If any command status other than zero is returned, then no data 
was retrieved by the command and the values of the data block's 
variables are unchanged. 
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B. Command Details 


GETC GET data from Current of run unit GETC 

Command and Arguments 
GETC, oblk 

Currency Indicators 

Used : CRU Changed : none 

Description 

All data values in the record that is the current of run unit are 
returned in the host language variables of oblk. The types, 
sizes and sequence of these variables must be consistent with the 
data items that make up the record type for the current of run 
unit. A command status error is returned if a user does not have 
read access to all data items that make up the record type for 
the current of run unit. 

Examples of Command Usage 

block/direct ... EO ■ GETC ("oblk") 
block/indirect ... EO ■ DMS ("GETC, oblk" ) 
record/direct ... EO » GETC (oblk) 
record/ indirect .. . EO = DMSD ("GETC" , oblk) 


GETM GET data from Member getm 


Command and Argument 
GETM, set-1 ,oblk 
Currency Indicators 

Used : CM (set-1) Changed : none 

Description 

All data values in the current member of set-1 are returned in 
the host language variables of oblk. The types, sizes and 
sequence of these variables must be consistent with the data 
items that make up the member record type of set-1. A command 
status error is returned if a user does not have read access to 
all data items of the member record type of set-1. 

Examples of Command Usage 

block/direct ... EO = GETM (" set-1 , oblk" ) 
block/indirect ... EO = DMS ("GETM, set-1, oblk”) 
record/direct ... EO = GETM ("set-1" , oblk) 
record/indirect... EO = DMSD ( "GETM, set-1 ", oblk) 
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QEXQ 


GE T data from Qwner 


QE1Q 


Command and Argument 
GETO, set-1 ,oblk 
Currency Indicators 

USfid: CO (set-1) Chanssd: none 

Description 

All data values in the current owner of set-1 are returned in the 
host language variables of oblk. The types, sizes and sequence 
of these variables must be consistent with the data items that 
make up the owner record type of set-1. A command status error 
is returned if a user does not have read access to all data items 
of the owner record type of set-1. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= GETO ("set-1 , oblk") 

= DMS ( "GETO, set-1, oblk") 

= GETO ("set-1", oblk) 

■ DMSD ("GETO, set-1", oblk) 


GEG Get Eield from Current of run unit GFC 

Command and Arguments 
GFC, itm,oblk 
Currency Indicators 

Used: CRU Changed: none 

Description 

The value of the itm data item (field) in the record that is the 
current of run unit is returned in the host language variable of 
oblk. The type and size of this variable must be consistent with 
the type and size of itm in the DDL specification. A command 
status error is returned if a user does not have read access to 
the itm field. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= GFC ("itm, oblk") 

= DMS ( "GFC, itm, oblk") 

= GFC ("itm", oblk) 

= DMSD ("GFC, itm", oblk) 
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GEM Get Field from Member GFM 


Command and Arguments 

GFM, itm, set-1 , oblk 
Currency Indicators 

Used: CM (set-11 Changed: none 

Description 

The value of the item data item (field) in the current member of 
set-1 is returned in the host language variable of oblk. The 
type and size of this variable must be consistent with the type 
and size of itm in the DDL specification. A command status error 
is returned if a user does not have read access to the itm field. 

Examples of Command Usage 

block/direct ... EO = GFM ( "itm, set-1 , oblk") 
block/indirect ... EO = DMS ( "GFM, itm, set-1 , oblk " ) 
record/direct ... EO = GFM ( "itm, set-1 ", oblk) 
record/indirect... EO = DMSD ( "GFM, itm, set-1 ", oblk) 


GFQ Get field from Qwner GFQ 


Command and Arguments 

GFO, itm, set-1 , oblk 
Currency Indicators 

Uaed: co (set-i) Changed: none 

Description 

The value of the item data item (field) in the current owner of 
set-1 is returned in the host language variable of oblk. The 
type and size of this variable must be consistent with the type 
and size of itm in the DDL specification. A command status error 
is returned if a user does not have read access to the itm field. 

Examples of Command Usage 

block/direct ... EO = GFO ( "itm, set-1 , oblk") 
block/indirect ... EO = DMS ( "GFO, itm, set-1 , oblk") 
record/direct ... EO = GFO ( "itm, set-1 ", oblk) 
record/indirect... EO = DMSD ( "GFO, itm, set-1 ", oblk) 
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odrk Qbtain Duplicate Record based on calc gey QDBX 

Command and Arguments 
ODRK,rec,blk 
Currency Indicators 

Used : CRU Changed : CRU< record having duplicate 

calc key value 


Description 

The types, sizes and sequence of host language variables 
designated for blk must be consistent with the data items defined 
for rec. Before ODRK is invoked, the desired calc key value 
should be assigned to the blk variable (s) that corresponds to the 
calc key's data item(s) . 

If the current of run unit is not null when ODRK Is i nvoked: 
Obtain an occurrence of the same record type as the current of 
run unit, and having a calc key value that matches the calc key 
value held in blk's variable (s). If such a record exists, it 
becomes the new current of run unit and the obtained data values 
are returned in the host language variables of blk. This command 
is valid only if the record that is the current of run unit is an 
occurrence of rec and rec has been defined (in the DDL) as having 
a calc key. The calc key value indicated by blk must duplicate 
the calc key value of the current of run unit, otherwise a 
command status error results, no record is obtained and the 
current of run unit is not altered. 


Use of ORK, followed by repeated use of ODRK, will obtain all 
records of a given record type having the same calc key value. 
The order in which these are obtained is not guaranteed. If an 
ODRK command is given when there are no more duplicates of a 
particular calc key value, then the command status is 255, no 
record is obtained, and the current of run unit becomes null. 

If a user does not have read access to all of rec's data items, 
then a command status error results. The record is not obtained, 
but it does become the current of run unit. 


JL£ the cur re nt af. JLUD unit is null when ODRK is invoked : ODRK 

has exactly the same effect as ORK. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= ODRK ("rec, blk") 

= DMS ("ODRK, rec, blk") 

= ODRK ("rec", blk) 

= DMSD ("ODRK, rec", blk) 
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OFM Qbtain E.irst Eember OFM 


Command and Arguments 
OFM, set-1 ,oblk 
Currency Indicators 

Used : CO(set-l) Changed : CM(set-l)< first member (set-1) 

CRU f — first member (set-1) 

Description 

The first member connected to the current owner of set-1 is 
obtained. It becomes the current member of set-1 and the current 
of the run unit. Its data values are returned in the host 
language variables of oblk. The types, sizes and sequence of 
variables designated for oblk must conform to the data items 
existing for the member record type. Which member is first 
depends on the set-1 member order, as specified with the DDL. 

If the current owner of set-1 has no member, then the command 
status is 255, no record is obtained, the current of run unit 
becomes null, and the current member of set-1 is null. If a user 
does not have read access to set-1, then a command status error 
is returned, no record is obtained, and the currency indicators 
are unchanged. If a user has read access to set-1 but not to all 
data items of its member record type, then a command status error 
results. The currency indicators are changed, but no record is 
obtained . 

Examples of Command Usage 

block/direct ... EO = OFM ("set-1 , oblk" ) 
block/indirect ... EO = DMS ( "OFM, set-1 , oblk" ) 
record/direct ... EO = OFM ("set-1" , oblk) 
record/indirect... EO = DMSD ( "OFM, set-1" , oblk) 
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om 


Qbtain £irst Owner 


om 


Command and Arguments 
OFO, set-1, oblk 
Currency Indicators 

Used : CM(set-l) Changed : CO(set-l)^ first owner (set-1) 

CRU f-f irst owner (set-1) 

Description 

The first owner connected to the current member of set-1 is 
obtained. It becomes the current owner of set-1 and the current 
of the run unit. Its data values are returned in the host 
language variables of oblk. The types, sizes and sequence of 
variables designated for oblk must be consistent with the data 
items existing for the owner record type. Which owner is first 
depends on the set-1 owner order, as specified with the DDL. 

If the current member of set-1 has no owner, then the command 
status is 255, no record is obtained, the current of run unit is 
null, and the current owner of set-1 is null. If a user does not 
have read access to set-1, then a command status error is 
returned, no record is obtained, and currency indicators are 
unchanged. If a user has read access to set-1 but not to all 
data items of its owner record typey then a command status error 
results. The currency indicators are changed, but no record is 
obtained . 


Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/ indirect .. . EO 


OFO ("set-1, oblk") 

DMS ("OFO, set-1, oblk") 
OFO ("set-1" , oblk) 

DMSD ("OFO, set-1" , oblk) 
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QLM Qbtain Last Member OLM 


Command and Arguments 
OLM, set-1, oblk 
Currency Indicators 

Used : CO(set-l) Changed : CM(set-l)f last member (set-1) 

CRU ( — last member (set-1) 

Description 

The last member connected to the current owner of set-1 is 
obtained. It becomes the current member of set-1 and the current 
of the run unit. Its data values are returned in the host 
language variables of oblk. The types, sizes and sequence of 
variables designated for oblk must be consistent with data items 
existing for the member record type. Which member is last 
depends on the set-1 member order, as specified with the DDL. 

If the current owner of set-1 has no member, then the command 
status is 255, no record is obtained, the current of run unit 
becomes null and the current member of set-1 becomes null. If a 
user does not have read access to set-1, then a command status 
error is returned, no record is obtained, and the currency 
indicators are unchanged. If a user has read access to set-1 but 
not to all data items of its member record type, then a command 
status error results. The currency indicators are changed, but 
no record is obtained. 

Examples of Command Usage 

block/direct ... EO = OLM ("set-1 , oblk" ) 
block/indirect ... EO = DMS ("OLM, set-1 , oblk" ) 
record/direct ... EO = OLM ("set-1” ,oblk) 
record/indirect... EO = DMSD ("OLM, set-1" , oblk) 
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OLO Qbtain Last Qwner OLO 


Command and Arguments 
OLO, set-1 ,oblk 
Currency Indicators 

Used : CM(set-l) Changed : CO (set-1) ( — last owner (set-1) 

CRU < — last owner (set-1) 

Description 

The last owner connected to the current member of set-1 is 
obtained. It becomes the current owner of set-1 and the current 
of the run unit. Its data values are returned in the host 
language variables of oblk. The types, sizes and sequence of 
variables designated for oblk must be consistent with data items 
existing for the owner record type. Which owner is last depends 
on the set-1 owner order, as specified with the DDL. 

If the current member of set-1 has no owner, then the command 
status is 255, no record is obtained, the current of run unit 
becomes null, and the current owner of set-1 becomes null. If a 
user does not have read access to set-1, then a command status 
error is returned, no record is obtained, and no currency 
indicators are changed. If a user has read access to set-1 but 
not to all data items of its owner record type, then a command 
status error results. The currency indicators are changed, but 
no record is obtained. 

Examples of Command Usage 

block/direct ... EG = OLO ("set-1, oblk") 
block/indirect ... EO = DMS ("OLO, set-1, oblk") 
record/direct ... EO = OLO ("set-1" , oblk) 
record/indirect... EO = DMSD ("OLO, set-1" , oblk) 
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mu 


Obtain Member based on data item 


QUI 


Command and Arguments 
OMI, itm, set-1 ,blk 
Currency Indicators 

Used : CO(set-l) Changed : CM (set-1) first member (set-1) 

CRU ^ having data item value 

Description 

The types, sizes and sequence of host language variables 
designated for blk must be consistent with the data items 
existing for the member record type of set-1. Before OMI is 
invoked, the desired item value should be assigned to the blk 
variable that corresponds to itm. The system obtains the first 
member record connected to the current owner of set-1, and having 
the indicated value for itm. It becomes the current member of 
set-1 and the current of run unit. The obtained data values are 
returned in the nost language variables of blk. If there are two 
or more member records for the current owner of set-1, all having 
the blk value for itm, which one is first depends on the set-1 
member order. The command ONMI can be used to obtain the next 
member having the same value for itm. 


If the value of blk's host language variable does not match the 
itm value of any member record connected to the current owner of 
set-1, then the command status is 255, no record is obtained, the 
current member of set-1 becomes null, and the current of run unit 
becomes null. If a user does not have read access to set-1 and 
itm, then a command status error will result, no record will be 
obtained, and currency indicators will remain unchanged. If a 
user has read access to set-1 and itm but not to all data items 
of the member record type, then a command status error results. 
The currency indicators are changed, but no record is obtained. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= OMI ("itm, set-1 , blk" ) 

= DMS ("OMI, itm, set-1, blk" ) 

= OMI ("itm, set-1" , blk) 

= DMSD ("OMI, itm, set-1", blk) 
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OMSK Obtain Member based on £ort Key QM££ 


Command and Arguments 
OMSK, set-1, blk 
Currency Indicators 

Used : CO (set-1) Changed : CM(set-l). first member (set-1) 

CRU having sort key value 


Description 

Set-1 must have a sorted member order. The types, sizes and 
sequence of host language variables designated for blk must be 
consistent with the data items existing for the member record 
type of set-1. Before OMSK is invoked, the desired sort key 
value should be assigned to the blk variable (s) that corresponds 
to the sort key's data item(s) . If RECORD-TYPE is part of the 
sort key, then OMSK cannot be used in place of PMSK and GETC. 
The system obtains the first member record connected to the 
current owner of set-1 and having the indicated sort key value. 
This record becomes the current member of set-1 and the current 
of run unit. Its data values are returned in the host language 
variables of blk. 

If several member records for the current owner of set-1 have the 
same sort key value, the one that is first depends on the DDL 
sort-clause specification for the set-1 member order (either 
LIFO, FIFO, or IMMATERIAL) . 

If the current owner of the set-1 has no member whose sort key 
value matches the sort key value of blk, then the command status 
is 255 and no record is obtained. The member whose sort key 
value immediately follows the blk sort key value becomes the 
current member of set-1, as well as the current of run unit. The 
exceptions are when the current owner of set-1 has no members or 
when blk's sort key value is greater than the sort key value of 
the last member of set-1' s current owner. In these cases, the 
current member of set-1 becomes null and the current of run unit 
becomes null. 


A command status error is returned if a user does not have read 
access to set-1 and all data items that make up the member sort 
key. No record is obtained and currency indicators are 
unchanged. If a user has read access to set-1 and the sort key 
but not to all data items of the member record type, then a 
command' status error is returned. Currency indicators are 
changed, but no record is obtained. 


Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/ indirect. . . EO 


OMSK ("set-1, blk") 

DMS ("OMSK, set-1, blk") 
OMSK ("set-1", blk) 

DMSD ("OMSK, set-1", blk) 
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Qbtain J&ext Member 




Command and Arguments 
ONM, set-1 , oblk 
Currency Indicators 

Used : CO (set-1) Chanced : CM(set-l)< next member (set-1) 

CM (set-1) CRU < next member (set-1) 


Description 

If the cu rrent m e rnfafi x oL set-1 is uat null when OHM is invoked : 
The next member record (connected to the current owner of set-1) 
following the current member of set-1 is obtained. It becomes 
the new current member of set-1 and the current of run unit. Its 
data values are returned in the host language variables of oblk. 
The types, sizes and sequence of variables designated for oblk 
must be consistent with data items existing for the member record 
type. Which member record is logically next depends on the set-1 
member order, as specified with the DDL. 

If the current member of set-1 is the last member for the current 
owner of set-1, then ONM cannot find a next member. When there 
is no next member for the current owner of set-1, the command 
status is 255, no record is obtained, the current member of set-1 
becomes null, and the current of run unit becomes null. If a 
user does not have read access to set-1, then a command status 
error is returned, no record is obtained, and the currency 
indicators remain unchanged. If a user has read access to set-1 
but not to all data items of its member record type, then a 
command status error results. The currency indicators are 
changed, but no record is obtained. 


If the current member af set-1 is null when ONM is invoked : ONM 

has exactly the same effect as OFM. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= ONM ("set-1, oblk") 

= DMS ("ONM, set-1, oblk") 

= ONM ("set-1" , oblk) 

= DMSD ("ONM, set-1", oblk) 
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QNMI 


Obtain Next Member based on data Item QNMI 


Command and Arguments 

ONMI, itm, set-1 ,blk 
Currency Indicators 

Used : CO (set-1) Changed : CM (set-1) next member (set-1) 

CM (set-1) CRU * with item value 

Description 

The types, sizes and sequence of host language variables 
designated for blk must be consistent with the data items 
existing for the member record type of set-1. Before ONMI is 
invoked, the desired item value should be assigned to the blk 
variable that corresponds to itm. 


If the current member of set-1 is not null when ONMI is invoked : 
The system obtains the next member record connected to the 
current owner of set-1 and having the indicated value for itm. 
This record becomes the current member of set-1 and the current 
of run unit. The obtained data values are returned in the host 
language variables of blk. If there are two or more member 
records following the current member of set-1, all having the blk 
value for itm, which one is next depends on the set-1 member 
order. If there is no next member with the indicated value for 
itm, the command status is 255, no record is obtained, the 
current member of set-1 becomes null, and the current of run unit 
becomes null. If a user does not have read access to both itm 
and set-1, then a command status error is returned, no record is 
obtained, and currency indicators remain unchanged. If a user 
has read access to set-1 and itm but not to all member data 
items, then a command status error results. Currency indicators 
are changed, but no data values are retrieved. 


11 the current member ol set-1 Is mill when QNMI As invoked : 
ONMI has exactly the same effect as OMI. The first member record 
connected to the current owner of set-1, and having a value for 
itm that matches the indicated blk value becomes the current 
member of set-1. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= ONMI (" itm, set-1 , blk" ) 

= DMS ("ONMI, itm, set-1, blk") 

= ONMI ("itm, set-1", blk) 

= DMSD ("ONMI, itm, set-1", blk) 
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ONMSK Obtain Next Member based on Sort £ey ONMSK 


Command and Arguments 
ONMSK/ set-1, bile 
Currency Indicators 

Used : CO (set-1) Changed : CM (set-1) ["next member 

CM (set-1) CRU ^ (set-1) having 

_sort key value 

Description 

Set-1 must have a sorted member order. The type, sizes and 
sequence of host language variables designated for blk must be 
consistent with the data items existing for the member record 
type of set-1. Before ONMSK is invoked, the desired sort key 
value should be assigned to the blk variable (s) that corresponds 
to the sort key's data item(s) . If RECORD-TYPE is part of the 
sort key, then ONMSK cannot be used in place of FNMSK and GETC. 
The system obtains the next member record (after the current 
member) that has the indicated sort key value and is connected to 
the current owner of set-1. This record becomes the current 
member of set-1 and the current of run unit. Its data values are 
returned in the nost language variables of blk. 

If set-1 has no current member, then ONMSK behaves just as OMSK. 
If several member records for the current owner of set-1 have the 
same sort key value, the one that is next depends on the DDL 
sort-clause specification for the set-1 member order (either 
LIFO, FIFO, or IMMATERIAL) . 

If the current owner of the set-1 has no member (after the 
current member) whose sort key value matches the sort key value 
of blk, then the command status is 255 and no record is obtained. 
The next member immediately following the current member becomes 
the current member of set-1, as well as the current of run unit. 
The exceptions are when the current owner of set-1 has no members 
or when blk's sort key value is greater than the sort key value 
of the last member of set-1 ' s current owner. In these cases, the 
current member of set-1 becomes null and the current of run unit 
becomes null. 

A command status error is returned if a user does not have read 
access to set-1 and all data items that make up the member sort 
key. No record is obtained and currency indicators are 
unchanged. If a user has read access to set-1 and the sort key 
but not to all member data items, then a command status error 
results. The currency indicators are changed, but no data values 
are retrieved. 

Examples of Command Usage 

block/direct ... EO = ONMSK ("set-1 , blk" ) 
block/indirect ... EO » DMS ("ONMSK, set-1, blk" ) 
record/direct ... EO = ONMSK ("set-1" , blk) 
record/indirect... EO = DMSD ("ONMSK, set-1" , blk) 
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om 


Qbtain next £wner 


om 


Command and Arguments 
ONO, set-1, oblk 
Currency Indicators 

Used : CM(set-l) Changed ; C0(set-1)< next owner (set-1) 

CO (set-1) CRU < next owner (set-1) 


Description 

H iiis nnixanL owner oL set-i la noL null when QEQ Is. in v oked: 
The next owner record (connected to the current member of set-1) 
following the current owner of set-1 is obtained. This record 
becomes the new current owner of set-1 and the current of run 
unit. Its data values are returned in the host language 
variables of oblk. The types, sizes and sequence of variables 
designated for oblk must be consistent with data items existing 
for the owner record type. Which owner record is logically next 
depends on the set-1 owner order, as specified with the DDL. 

If the current owner of set-1 is the last owner for the current 
member of set-1, then ONO cannot find a next owner. When there 
is no next owner for the current member of set-1, the command 
status is 255, no record is obtained, the current owner of set-1 
becomes null, and the current of run unit becomes null. If a 
user does not have read access to set-1, then a command status 
error is returned, no record is obtained, and currency indicators 
remain unchanged. If a user has read access to set-1 but not to 
all owner data items, then a command status error results. 
Currency indicators are changed, but no data values are 
retrieved. 

JJL cur rent .owner oL aet-l Is null when QNQ Is. i nvo ked; ono 

has exactly the same effect as 0F0. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/ indirect. . . EO 


= ONO ("set-1, oblk") 

■ DMS ("ONO, set-1, oblk") 

= ONO ("set-1", oblk) 

= DMSD ("ONO, set-1", oblk) 
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QNOI Obtain Next Owner based on data Item Qnoi 


Command and Arguments 

ONOI, itm, set-1, blk 

Currency Indicators 

Used : CM (set-1) 

CO (set-1) 

Description 

The types, sizes and sequence of host language variables 
designated for blk must be consistent with the data items 
existing for the owner record type of set-1. Before ONOI is 
invoked, the desired item value should be assigned to the blk 
variable that corresponds to itm. 

II tha 2ULLS1 lL owner at set-1 in nat mil when Q.NQ.I la invoked : 
The system obtains the next owner record connected to the current 
member of set-1 and having the indicated value for itm. This 
record becomes the current owner of set-1 and the current of run 
unit. The obtained data values are returned in the host language 
variable of blk. If there are two or more owner records 
following the current owner of set-1, all having the blk value 
for itm, which one is next depends on the set-1 owner order. If 
there is no next owner with the indicated value for itm, then the 
command status is 255, no record is obtained, the current owner 
of set-1 becomes null, and the current of run unit becomes null. 
If a user does not have read access to both itm and set-1, then a 
command status error is returned, no record is obtained, and 
currency indicators remain unchanged. If a user has read access 
to set-1 and itm but not to all owner data items, then a command 
status error results. Currency indicators are changed, but no 
data are retrieved. 

It the current o w ne r at set-1 in null when QNOI la invoked; onoi 
has exactly the same effect as 001. The first owner record 
connected to the current member of set-1, and having a value for 
itm that matches the indicated blk value becomes the current 
owner of set-1 . 

Examples of Command Usage 

block/direct ... EO = ONOI ("itm, set-1, blk") 
block/indirect ... EO = DMS ( "ONOI, itm, set-1 , blk" ) 
record/direct ... EO = ONOI ("itm, set-1" , blk) 
record/indirect... EO = DMSD ("ONOI, itm, set-1", blk) 


CO (set-1) 
CRU 


next owner (set-1) 
with item value 
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onqsk Obtain Uext £wner based on Sort Key QNQS& 


Command and Arguments 
ONOSK, set-1 ,blk 
Currency Indicators 

Used : CO (set-1) Changed : CO (set-1) [“next owner (set-1) 

CM (set-1) CRU < having sort key 

_value 

Description 

Set-1 must have a sorted owner order. The types, sizes and 
sequence of host language variables designated for blk must be 
consistent with the data items existing for the owner record type 
of set-1. Before ONOSK is invoked, the desired sort key value 
should be assigned to the blk variable (s) that corresponds to the 
sort key's data item(s) . If RECORD-TYPE is a part of the sort 
key, then ONOSK cannot be used in place of FNOSK and GETC. The 
system obtains the next owner record (after the current owner) 
that has the indicated sort key value and is connected to the 
current member of set-1. This record becomes the current owner 
of set-1 and the current of the run unit. Its data values are 
returned in the host language variables of blk. 

If set-1 has no current owner, then ONOSK behaves just as OOSK. 
If several owner records for the current member of set-1 have the 
same sort key value, the one that is next depends on the DDL 
sort-clause specification for the set-1 owner order (either LIFO, 
FIFO, or IMMATERIAL) . 

If the current member of the set-1 has no owner (after the 
current owner) whose sort key value matches the sort key value of 
blk, then the command status is 255 and no record is obtained. 
The next owner immediately following the current member becomes 
the current owner of set-1, as well as the current of run unit. 
The exceptions are when the current member of set-1 has no owners 
or when blk's sort key value is greater than the sort key value 
of the last owner of set-1 1 s current member. In these cases, the 
current owner of set-1 becomes null and the current of run unit 
becomes null. 


A command status error is returned if a user does not have read 
access to set-1 and all data items that make up the owner sort 
key. No record is obtained and currency indicators are 
unchanged. If a user has read access to set-1 and the sort key 
but not to all owner data items, then a command status error 
results. Currency indicators are changed, but no data are 
retrieved. 

Examples of Command Usage 

block/direct ... EO = ONOSK ("set-1 , blk" ) 
block/indirect ... EO = DMS ( "ONOSK, set-1 , blk" ) 
record/direct ... EO = ONOSK ("set-1" , blk) 
record/indirect... EO = DMSD ("ONOSK, set-1" , blk) 
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OOI Qbtain £wner based on data Xtem ooi 


Command and Arguments 
OOI, itm, set-1, blk 

Currency Indicators 

Used : CM(set-l) Changed : CO (set-1) . first owner (set-1) 

CRU ^ having data item value 

Description 

The types, sizes and sequence of host language variables 

designated for blk must be consistent with the data items 
existing for the owner record type of set-1. Before OOI is 
invoked, the desired item value should be assigned to the blk 
variable that corresponds to itm. The system obtains the first 
owner record connected to the current member of set-1 and having 
the indicated value for itm. This record becomes the current 
owner of set-1 and the current of run unit. The obtained data 
values are returned in the host language variables of blk. If 

there are two or more owner records for the current member of 
set-1, all having the blk value for itm, which one is first 

depends on the set-1 owner order. The command ONOI can be used 
to obtain the next owner having the same value for itm. 

If the value of blk's host language variable for itm does not 
match the itm value of any owner record connected to the current 
member of set-1, then the command status is 255, no record is 
obtained, the current owner of set-1 becomes null, and the 
current of run unit becomes null. If a user does not have read 

access to both itm and set-1, then a command status error will 

result, no record will be obtained, and currency indicators will 
remain unchanged. If a user has read access to set-1 and itm but 
not to all owner data items, then a command status error results. 
Currency indicators are changed, but no data are retrieved. 

Examples of Command Usage 

block/direct ... EO = OOI ("itm, set-1, blk") 
block/indirect ... EO = DMS ( "OOI, itm, set-1 , blk" ) 
record/direct ... EO = OOI ("itm, set-1" , blk) 
record/indirect... EO = DMSD ( "OOI, itm, set-1" , blk) 
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OOSK Obtain Owner based on Oort E.ey OOSK 


Command and Arguments 
OOSK, set-1 ,blk 

Currency Indicators 

Used ; CM(set-l) Changed ; CO(set-l)^. first owner (set-1) 

CRU ^ having sort key value 

Description 

Set-1 must have a sorted owner order. The types, sizes and 

sequence of host language variables designated for blk must be 
consistent with the data items existing for the owner record type 
of set-1. Before OOSK is invoked, the desired sort key value 
should be assigned to the blk variable (s) that corresponds to the 
sort key's data item(s) . If RECORD-TYPE is part of the sort key, 
then OOSK cannot be used in place of FOSK and GETC. The system 
obtains the first owner record connected to the current member of 

set-1 and having the indicated sort key value. This record 

becomes the current owner of set-1 and the current of the run 
unit. Its data values are returned in the host language 

variables of blk. 

If several owner records for the current member of set-1 have the 
same sort key value, the one that is first depends on the DDL 
sort-clause specification for the set-1 owner order (either LIFO, 
FIFO, or IMMATERIAL) . 

If the current member of the set-1 has no owner whose sort key 
value matches the sort key value of blk, then the command status 
is 255 and no record is obtained. The owner whose sort key value 
immediately follows the blk sort key value becomes the current 
owner of set-1, as well as the current of run unit. The 
exceptions are when the current member of set-1 has no owners or 
when blk's sort key value is greater than the sort key value of 
the last owner of set-1' s current member. In these cases, the 
current owner of set-1 becomes null and the current of run unit 
becomes null. 


A command status error is returned if a user does not have read 
access to set-1 and all data items that make up the owner sort 
key. No record is obtained and currency indicators are 
unchanged. If a user has read access to set-1 and the sort key 
but not to all owner data items, then a command status error 
results. Currency indicators are changed, but no data are 
retrieved . 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= OOSK ("set-1, blk") 

= DMS ("OOSK, set-1, blk") 
= OOSK ("set-1" , blk) 

= DMSD ("OOSK, set-1" , blk) 
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QPM Qbtain prior Member QPM 

Command and Arguments 
OPM, set-1, oblk 


Currency Indicators 

Used : CO (set-1) 

CM (set-1) 


Changed: 


CM (set-1) prior 

CRU < prior 


member (set-1) 
member (set-1) 


Description 

II Aha Q.ur. LS.hf member M ae.t-1 is nab null when Qm lb invoked : 
The prior member record (connected to the current owner of set-1) 
preceding the current member of set-1 is obtained. This record 
becomes the new current member of set-1 and the current of run 
unit. Its data values are returned in the host language 
variables of oblk. The types, sizes and sequence of variables 
designated for oblk must be consistent with data items existing 
for the member record type. Which member record is logically 
prior depends on the set-1 member order, as specified with the 
DDL. 


If the current member of set-1 is the first member for the 
current owner of set-1, then OPM cannot find a prior member. 
When there is no prior member for the current owner of set-1, 
then the command status is 255, the current member of set-1 
becomes null, and the current of run unit becomes null. If a 
user does not have read access to set-1, then a command status 
error is returned and the currency indicators remain unchanged. 
If a user has read access to set-1 but not to all member data 
items, then a command status error results. Currency indicators 
are changed, but no data are retrieved. 

If. the current member <?f set-1 is null when OPM is invoked : OPM 
has exactly the same effect as OLM. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/ indirect. . . EO 


= OPM ("set-1, oblk") 

= DMS ("OPM, set-1, oblk") 

= OPM ("set-1", oblk) 

= DMSD ("OPM, set-1", oblk) 
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OPMI 


Obtain Erior Member based on data item OPMI 


Command and Arguments 

OPMI , itm, set-1 ,blk 


Currency Indicators 

Used : CO(set-l) Changed : CM(set-l)^ prior member (set-1) 

CM (set-1) CRU with item value 

Description 

The types, sizes and sequence of host language variables 
designated for blk must be consistent with the data items 
existing for the member record type of set-1. Before OPMI is 
invoked, the desired item value should be assigned to the blk 
variable that corresponds to itm. 

II the current member qlL set-1 la not null when QEMI in, invoked: 
The system obtains the prior member record connected to the 
current owner of set-1 and having the indicated value for itm. 
This record becomes the current member of set-1 and the current 
of run unit. The obtained data values are returned in the host 
language variable of blk. If there are two or more member 
records preceding the current member of set-1, all having the blk 
value for itm, which one is prior depends on the set-1 member 
order. If there is no prior member with the indicated value for 
itm, then the command status is 255, no record is obtained, the 
current member of set-1 becomes null, and the current of run unit 
becomes null. If a user does not have read access to both itm 
and set-1, then a command status error is returned, no record is 
obtained, and currency indicators remain unchanged. If a user 
has read access to itm and set-1 but not to all member data 
items, then a command status error results. Currency indicators 
are changed, but no data are retrieved. 


UL the Quxxs nt msmhgr qJl s.etrl Is. mill wiian QEMI Is, in.v o @ 1 k.£d: The 

last member record connected to the current owner of set-1, and 
having a value for itm that matches the indicated blk value 
becomes the current member of set-1. 


Examples of Command Usage 


block/direct ... EO 
block/ indirect ... EO 
record/direct ... EO 
record/indirect... EO 


OPMI ("itm, set-1, blk”) 

DMS ("OPMI, itm, set-1, blk") 
OPMI ("itm, set-1" , blk) 

DMSD ("OPMI, itm, set-1" , blk) 
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OPMSK Obtain Erior Member based on Oort Key OPMSK 


Command and Arguments 
OPMSK, set-1, blk 

Currency Indicators 

Used : CO(set-l) Changed : CM(set-l) [prior member 

CM(set-l) CRU ^ (set-1) having 

_sort key value 

Description 

Set-1 must have a sorted member order. The types, sizes and 
sequence of host language variables designated for blk must be 
consistent with the data items existing in the member record type 
for set-1. Before OPMSK is invoked, the desired sort key value 
should be assigned to the blk variable (s) that corresponds to the 
sort key's data item(s). If RECORD-TYPE is part of the sort key, 
then OPMSK cannot be used in place of FPMSK and GETC. The prior 
member record (after the current member) that has the sort key 
value of blk and that is connected to the current owner of set-1 
becomes the current member of set-1 and the current of the run 
unit . 

If set-1 has no current member, then the last member having the 
sort key value is found. If several member records for the 
current owner of set-1 have the same sort key value, the one that 
is prior depends on the DDL sort-clause specification for the 
set-1 member order (either LIFO, FIFO, or IMMATERIAL). 

If the current owner of the set-1 has no member (before the 
current member) whose sort key value matches the sort key value 
of blk, then the command status is 255 and no record is obtained. 
The member immediately preceding the current member becomes the 
current member of set-1, as well as the current of run unit. The 
exceptions are when the current owner of set-1 has no members or 
when blk's sort key value is lower than the sort key value of the 
first member of set-l's current owner. In these cases, the 
current member of set-1 becomes null and the current of run unit 
becomes null. 

A command status error is returned if a user does not have read 
access to set-1 and all data items that make up the member sort 
key. No record is obtained and currency indicators remain 
unchanged. If a user has read access to set-1 and the sort key 
but not to all member data items, then a command status error 
results. Currency indicators are changed, but no data are 
retrieved . 

Examples of Command Usage 

block/direct ... EO = OPMSK ("set-1, blk") 
block/indirect ... EO = DMS ("OPMSK, set-1, blk") 
record/direct ... EO = OPMSK ("set-1" , blk) 
record/indirect... EO = DMSD ("OPMSK , set-1" , blk) 
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OPO Obtain Erior Owner OPO 

Command and Arguments 
OPO/set-l,oblk 
Currency Indicators 

Used : CM(set-l) Changed : CO(set-l)« prior owner(set-l) 

CO (set-1) CRU < prior owner (set-1) 

Description 

11 the current ow ner of set-1 is not mill when QEO is. iaaaKad: 
The prior owner record (connected to the current member of set-1) 
preceding the current owner of set-1 is obtained. This record 
becomes the new current owner of set-1 and the current of run 
unit. Its data values are returned in the host language 
variables of oblk. The types, sizes and sequence of variables 
designated for oblk must be consistent with data items existing 
for the owner record type. Which owner record is logically prior 
depends on the set-1 owner order, as specified with the DDL. 

If the current owner of set-1 is the first owner for the current 
member of set-1, then OPO cannot find a prior owner. When there 
is no prior owner for the current member of set-1, then the 
command status is 255, no record is obtained, the current owner 
of set-1 becomes null, and the current of run unit becomes null. 
If a user does not have read access to set-1, then a command 
status error is returned and currency indicators remain 
unchanged. If a user has read access to set-1 but not to all its 
owner data items, then a command status error results. Currency 
indicators are changed, but no data are retrieved. 

XI the, current ow ner o_£ set-1 is null w hen QEQ is. invoked : OPO 

has exactly the same effect as OLO. 


Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


OPO ("set-1, oblk") 

DMS ("OPO, set-1, oblk") 
OPO ("set-1" , oblk) 

DMSD ("OPO, set-1" , oblk) 
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QPOI 


Obtain £rior Owner based on data Xtem QPOI 


Command and Arguments 
OPOI, itm, set-1, blk 
Currency Indicators 

prior owner (set-1) 
with item value 

Description 

The type, sizes and sequences of host language variables 
designated for blk must be consistent with the data items 
existing for the owner record type of set-1. Before OPOI is 
invoked, the desired item value should be assigned to the blk 
variable that corresponds to itm. 

It tfrg current owner ol set-1 Is not null when QPOI ±£ invoked : 
The system obtains the prior owner record connected to the 
current member of set-1 and having the indicated value for itm. 
This record becomes the current owner of set-1 and the current of 
run unit. The obtained data values are returned in the host 
language variable of blk. If there are two or more owner records 
preceding the current owner of set-1, all having the blk value 
for itm, which one is prior depends on the set-1 owner order. If 
there is no prior owner with the indicated value for itm, then 
the command status is 255, no record is obtained, the current 
owner of set-1 becomes null, and the current of run unit becomes 
null. If a user does not have read access to both itm and set-1, 
then a command status error is returned, no record is obtained, 
and currency indicators remain unchanged. If a user has read 
access to itm and set-1, but not to all owner data items, then a 
command status error results. Currency indicators are changed, 
but no data are retrieved. 

It tim current owner ot set-1 Is null wh en QPOI Is. invoked: The 

last owner record connected to the current member of set-1, and 
having a value for itm that matches the indicated blk value 
becomes the current owner of set-1. 


Used : 


CM(set-l) 
CO (set-1) 


Changed : CO (set-1) 

CRU 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/ indirect. . . EO 


= OPOI ("itm, set-1, blk") 

= DMS ("OPOI, itm, set-1, blk") 

= OPOI ("itm, set-1", blk) 

= DMSD ("OPOI, itm,set-l", blk) 
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oposk Qbtain Erior fiwner based on Sort Key QPQSK 


Command and Arguments 
OPOSK, set-1 f blk 

Currency Indicators 

Used : CO (set-1) Changed : CO (set-1) [“prior owner (set-1) 

CM (set-1) CRU < having sort key 

_value 

Description 

Set-1 must have a sorted owner order. The types, sizes and 
sequence of host language variables designated for blk must be 
consistent with the data items existing for the owner record type 
of set-1. Before OPOSK is invoked, the desired sort key value 
should be assigned to the blk variable (s) that corresponds to the 
sort key's data item(s). If RECORD-TYPE is a part of the sort 
key, then OPOSK cannot be used in place of FPOSK and GETC. The 

system obtains the prior owner record (before the current owner) 
that has the indicated sort key value and is connected to the 
current member of set-1. This record becomes the current owner 
of set-1 and the current of the run unit. Its data values are 
returned in the host language variables of blk. 

If set-1 has no current owner, then the last owner having the 
sort key value is found. If several owner records for the 
current member of set-1 have the same sort key value, the one 
that is prior depends on the DDL sort-clause specification for 
the set-1 owner order (either LIFO, FIFO, or IMMATERIAL) . 

If the current member of the set-1 has no owner (before the 
current owner) whose sort key value matches the sort key value of 
blk, then the command status is 255 and no record is obtained. 
The owner immediately preceding the current member becomes the 
current owner of set-1, as well as the current of run unit. The 
exceptions are when the current member of set-1 has no owners or 
when blk’s sort key value is less than the sort key value of the 
first owner of set-1 1 s current member. In these cases, the 
current owner of set-1 becomes null and the current of run unit 
becomes null. 

A command status error is returned if a user does not have read 
access to set-1 and all data items that make up the owner sort 
key. No record is obtained and currency indicators are 
unchanged. If a user has read access to set-1 and the sort key 
but not to all owner data items, then a command status error 
results. Currency indicators are changed, but no data are 
retrieved. 

Examples of Command Usage 

block/direct ... EO = OPOSK ("set-1 , blk" ) 
block/indirect ... EO = DMS ("OPOSK, set-1 , blk" ) 
record/direct ... EO = OPOSK ("set-1" , blk) 
record/ indirect. . . EO = DMSD ("OPOSK, set-1", blk) 
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QR& 


Qbtain fiecord based on calc £ey 


sm 


Command Arguments 
ORK, rec f blk 
Currency Indicators 

Used : none Changed : CRU< record having calc 

key value 


Description 

This command is valid only if rec has a calc key clause in the 
DDL specification. The types, sizes and sequence of host 
language variables designated for blk must be consistent with the 
data items defined for rec. Before ORK is invoked, the desired 
calc key value should be assigned to the blk variable (s) that 
corresponds to the calc key's data item(s) . The system obtains 
an occurrence of rec having the indicated calc key value. This 
record becomes the current of run unit. 

Occurrences of rec with duplicate calc key values may exist in 
the data base, if the DDL specification declares that duplicates 
are allowed. If there is more than one occurrence of rec whose 
calc key value matches the indicated value, then ORK obtains one 
of these duplicates and ODRK can be used repeatedly to obtain 
each of the other duplicates. 

If there is no rec occurrence having the indicated calc key 
value, then the command status is 255, no record is obtained and 
CRU becomes null. A command status error is returned if a user 
does not have read access to all data items that make up rec's 
calc key. No record is obtained and currency indicators remain 
unchanged. If a user has read access to the calc key but not to 
all rec data items, then a command status error results. The 
current of run unit changes, but no data are retrieved. 

Examples of Command Usage 

block/direct ... EO = ORK ("rec, blk") 
block/indirect ... EO = DMS ("ORK, rec, blk") 
record/direct ... EO = ORK ("rec", blk) 
record/indirect... EO = DMSD ("ORK, rec", blk) 
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V. MODIFY COMMANDS 

A. Overview 

Six commands are available for modifying the data values of a 
record occurrence. Each command has the effect of transferring data 
from a host language variable (s) into a current record through the 
mechanism of a data block (or program record type). A record must be 
either the current owner of a set, the current member of a set, or the 
current of run unit before its data can be modified. In other words, 
the record must have been found before its data can be modified. 
Modify commands never alter any currency indicator. The modify 
commands fall into two groups. 

1. Put new values into all data items (i.e., fields) for the 

record that is the current owner of an indicated set, the 

current member of an indicated set, or the current of run 

unit. MDBS. DMS obtains these new values from the host 
language variable (s) of a specified data block. 

2. Put a new value into a pacticulai data item (i.e., field for 

the record that is the current owner of an indicated set, 
the current member of an indicated set, or the current of 
run unit. MDBS. DMS obtains the new value from the host 

language variable (s) of a specified data block. Commands in 

this group should be used where maximum data independence is 

desired. 

In either case, it is vital that the host language variables, 
containing data to be put into a record, are consistent with the type 
and size of the target data items. Where all data values of a record 
are being modified at once, the host language variables defined for 

the sending data block must also conform to the sequence of data items 

as defined for that record's type in the DDL. 

If a data value being modified is part of a sort key, MDBS. DMS 
automatically maintains the sorted order. 

A data item's value cannot be modified with the modify commands 

if this is part of a calc key. The modification can be accomplished 

by retrieving the record's contents, deleting the record from the data 
base, creating a new record having the old record's contents (except 
for the new calc key value), and re-establishing any relevant set 
connections . 

Data security conditions, as defined in a DDL schema 
specification, are automatically enforced when a data modification 
command is invoked. If the user of an application program attempts to 
perform a "put" that is inconsistent with that user's write access 
codes, a command status will result which indicates that the 
modification was not performed. 

If a data base has multiple areas, then all areas which permit 
pointer indices must be on-line during the execution of data 
modification commands 
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Data integrity conditions, as defined in a DDL schema 
specification, are automatically enforced when a data modification 
command is invoked. If an attempt is made to store a new data item 
value that is outside of the data item's feasible range of values, 
then a command status will result which indicates that the 
modification was not performed. 

If any command status other than zero is returned, then no data 
in the record (current owner, current member, or current of run unit) 
was modified. 


B. Command Details 


P££ £ut data into Eield of Current of run unit PFC 


Command and Arguments 
PFC, itm, iblk 


Currency Indicators 

Used: cru Changed: none 

Description 

The value of the iblk host language variable is put into the itm 
field of the record that is current of run unit. The type and 
size of this variable must be consistent with itm. A command 
status error is returned if the user does not have write access 
to itm and to the area containing the record to be changed. A 
command status error is also returned if the value of iblk's 
variable is outside of itm's feasibility range. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= PFC ("itm, iblk") 

= DMS ("PFC, itm, iblk") 

= PFC ("itm", iblk) 

= DMSD ("PFC, itm", iblk) 


EEM 


£ut data into field of Member 


EEH 


Command and Arguments 

PFM , itm, set-1 , iblk 
Currency Indicators 

Used: CM (set-1) Changed: none 
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Description 

The value of the iblk host language variable is put into the itm 
field of the current member of set-1. A command status error is 
returned if the user does not have write access to itm and to the 
area containing the record to be changed. A command status error 
is also returned if the value of iblk's variable is outside of 
itm's feasibility range. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= PFM ( "itm, set-1 , iblk") 

= DMS ("PFM, itm, set-1, iblk") 

= PFM ( "itm, set-1 ", iblk) 

= DMSD ("PFM, itm, set-1", iblk) 


E£Q 


Eut data into Eield of Qwner 


EEQ 


Command and Arguments 

PFO, itm, set-1 , iblk 
Currency Indicators 

Used: co (set-l) Changed: none 

Description 

The value of the iblk host language variable is put into the itm 
field of the current owner of set-1. A command status error is 
returned if the user does not have write access to itm and to the 
area containing the record to be changed. A command status error 
is also returned if the value of iblk's variable is outside of 
itm's feasibility range. 

Examples of Command Usage 


block/direct 
block/indirect . . . 
record/direct ... 
record/indirect. . . 


EO = PFO ("itm, set-1, iblk") 

EO = DMS ("PFO, itm, set-1, iblk") 
EO = PFO ( "itm, set-1 ", iblk) 

EO = DMSD ("PFO, itm, set-1", iblk) 


PUTC EOT data into Current of run unit pdtc 

Command and Arguments 
PUTC, iblk 

Currency Indicators 

Ufifid: CRU Changed: none 
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Description 

Data values of the iblk host language variables are put into the 
record that is the current of run unit. The types, sizes and 
sequence of these variables must be consistent with the data 
items that make up the record type for the current of run unit. 
A command status error is returned if the user does not have 
write access to all data items that make up the record type for 
the current of run unit and to the area containing the record to 
be changed. A command status error is also returned if the value 
of an iblk variable is outside of the feasibility range defined 
for the corresponding data item. 

Examples of Command Usage 

block/direct ... EO = PUTC ("iblk") 
block/indirect ... EO = DMS ( "PUTC, iblk") 
record/direct ... EO = PUTC (iblk) 
record/indirect... EO = DMSD ( "PUTC ", iblk) 


PUTM PHI data into Member ptttm 

Command and Arguments 
PUTM, set-1, iblk 
Currency Indicators 

CM (set-1) Changed: none 


Description 

Data values of the iblk host language variables are put into the 
current member of set-1. The types, sizes and sequence of these 
variables must be consistent with the data items that make up the 
member record type for set-1. A command status error is returned 
if the user does not have write access to all data items that 
make up the member record type and to the area containing the 
record to be changed. A command status error is also returned if 
the value of an iblk variable is outside the feasibility range 
defined for the corresponding data item. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= PUTM ("set-1, iblk") 

= DMS ("PUTM, set-1, iblk") 

= PUTM ("set-1", iblk) 

= DMSD ("PUTM, set-1, "iblk) 
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PUTO EUX data into Owner PUTQ 


Command and Arguments 
PUTO, set-1 , iblk 
Currency Indicators 

Used: CO (set-1) Ctiansed: none 

Description 

Data values of the iblk host language variables are put into the 
current owner of set-1. The types, sizes and sequence of these 
variables must be consistent with the data items that make up the 
owner record type for set-1. A command status error is returned 
if the user does not have write access to all data items that 
make up the owner record type and to the area containing the 
record to be changed. A command status error is also returned if 
the value of an iblk variable is outside the feasibility range 
defined for the corresponding data item. 

Examples of Command Usage 

block/direct ... EO = PUTO ( "set-1 , iblk") 
block/indirect ... EO = DMS ( "PUTO, set-1 , iblk") 
record/direct ... EO = PUTO ( "set-1 ", iblk) 
record/indirect... EO = DMSD ( "PUTO, set-1 , "iblk) 
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VI. ASSIGNMENT COMMANDS 


A. Overview 

Assignment commands allow an application programmer to assign a 
particular record (that has been previously found) to a currency 
indicator. Together with the find commands, the assignment commands 
form the basis for "navigating" through the record occurrences in a 
data base. As an example, suppose that a DEPT (department) record 
type owns an EMP (employee) record type through a IsN set named 
CONTAINS. A find command can be used to find a particular occurrence 
of DEPT, making that occurrence the current of run unit. An 
assignment command (SOC) can then be used to set the current owner of 
CONTAINS to be the same record as the current of run unit. This 
leaves the program poised to find various employees (members of 
CONTAINS) that are related to a particular department (the current 
owner of CONTAINS). The assignment commands fall into four major 
groups. 

1. Assign the new current of run unit to be the same as: 

the current owner of a particular set, 
the current member of a particular set, 
the current record of a particular user-defined 
indicator, or 

a previously saved current of run unit. 

The current of run unit can also be set to null and can be 
saved in the form of a data base key. It can also be set to 
null. 

2. Assign the new current member of a particular set to be the 
same as: 

the current of run unit, 
the current member of a particular set, 
the current owner of a particular set, or 
the current record of a particular user-defined 

indicator . 

The current member of any set can also be set to null. 

3. Assign the new current owner of a particular set to be the 
same as: 

the current of run unit, 
the current member of a particular set, 
the current owner of a particular set, or 
the current record of a particular user-defined 

indicator . 

The current owner of any set can also be set to null. 
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4. Assign the current record of a particular user-defined 
indicator to be the same as: 

the current of run unit, 
the current member of a particular set, 
the current owner of a particular set, or 
the current record of a particular user-defined 
indicator . 

A user-defined indicator can also be set to null. 

With the exception of SOE and SON, any assignment command that 
sets the current owner of set-1 to be the same as some other currency 
indicator also automatically performs FFM, set-1. With the exception 
of SME and SMN, any assignment command that sets the current member of 
set-1 to be the same as some other currency indicator also 
automatically performs FFO, set-1. The DBENV command can be used to 
suppress the automatic FFM and FFO operations for assignment commands. 
Instead of FFM, the current member becomes null. Instead of FFO, the 
current owner becomes null. Setting a run unit's environment in this 
way may allow the program to be more compact if it needs to loop 
through owners or members of a set. 

If a user does not have read access to all sets that are 
specified as arguments to an assignment command, then a command status 
error results and no currency indicator is altered. 
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B. Command Details 


sen 


Set Current 


of run unit 


to D.ata base key 


sen 


Command and Arguments 
SCD , iblk 

Currency Indicators 

Used ; none Changed ; CRU < data base key 

Description 

The value of iblk's host language variable becomes the new 
current of run unit. Normally, the value will be a data base key 
that was previously saved by the SDC command. If the system 
detects that the value is not a valid data base key, then command 
status error 49 results for SCD and the current of run unit 
remains unchanged. The integrity of the data base itself will 
not be damaged. 


In most environments, the iblk host language variable must be 
consistent with a four-byte binary data item. If some other type 
or size is necessary for a particular environment, then the 
difference is described in the pertinent system specific manual. 


Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


SCD ("iblk") 

DMS ("SCD, iblk") 
SCD (iblk) 

DMSD ("SCD", iblk) 


sen 


£et Current 


of run unit based on Member 


sen 


Command and Arguments 
SCM, set-1 

Currency Indicators 

Used : CM(set-l) Chang ed; CRU-s CM(set-l) 

Description 

The record that is presently the current member of set-1 becomes 
the new current of run unit. The current member of set-1 remains 
unchanged. If the user does not have read access to set-1, a 
command status error is returned and the current of run unit is 
unchanged . 
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Examples of Command Usage 

block/direct ... EO = SCM ("set-1") 
block/indirect ... EO = DMS ("SCM, set-1") 
record/direct ... EO = SCM ("set-1") 
record/indirect... EO = DMS ("SCM, set-1") 


sen 


S.et Current of run unit to Hull 


SCH 


Command and Arguments 

SCN (no arguments) 

Currency Indicators 

Used ; none Changed ; CRU< null 

Description 

The current of run unit becomes null. 
Examples of Command Usage 


block/direct ... 

EO 

= SCN 

( 

) 

block/indirect ... 

EO 

= DMS 

(* 

'SCN" ) 

record/direct ... 

EO 

= SCN 

( 

) 

record/indirect. . . 

EO 

= DMS 

( r 

’SCN") 


SCO Set Current of run unit based on Qwner SCO 


Command and Arguments 
SCO, set-1 


Currency Indicators 

Used ; CO(set-l) Changed ; CRU< CO(set-l) 

Description 

The record that is presently the current owner of set-1 becomes 
the new current of run unit. The current owner of set-1 remains 
unchanged. If the user does not have read access to set-1, a 
command status error is returned and the current of run unit is 
unchanged . 


Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


SCO ("set-1") 

DMS ("SCO, set-1") 
SCO ("set-1") 

DMS ("SCO, set-1") 
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scu Set Current of run unit based on User indicator SCU 


Command and Arguments 
SCU, iblk 


Currency Indicators 


Used ; CU(i) Changed ; CRU< CU(i) 

Description 

The current record of a user-defined indicator becomes the new 
current of run unit. The value of the host language variable for 
iblk determines which one of the user-defined indicators is 
involved in this command. The host language variable must be 
consistent with an unsigned data item that is one byte in size. 
The variable's value must be an integer between 1 and 255, 
inclusive. The current record of the user-defined indicator 
remains unchanged. The AUI command (Chapter XI) is employed to 
allocate user-defined indicators. 


Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


SCU (" iblk") 

DMS ("SCU, iblk”) 
SCU (iblk) 

DMSD ("SCU" , iblk) 


SDC Save ELata base key for Current of run unit SDC 

Command and Arguments 
SDC,oblk 

Currency Indicators 

Used: CRU Changed: none 

Description 

A data base key is a unique internal identifier for a record 
occurrence. The SDC command saves the data base key for the 
record that is the current of run unit. If the current of run 
unit is null, then a null data base key is saved. The data base 
key is saved in oblk's host language variable. In most 
environments, this variable must be consistent with a four-byte 
binary data item. If some other type or size is necessary for a 
particular environment, then the difference is described in the 
pertinent system specific manual. 
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The SDC command can be used to set the current of run unit to be 
the same as a saved data base key. 

Examples of Command Usage 

block/direct ... EO = SDC ("oblk") 
block/ indirect ... EO ■ DMS ("SDC, oblk") 
record/direct ... EO = SDC (oblk) 
record/ indirect .. . EO * DMSD ("SDC", oblk) 


SMC Set Member based on Current of run unit smc 


Command and Arguments 
SMC, set-1 

Currency Indicators 

Used : CRU Chanced : CIl(set-l)< CRU 

CO (set-1) < first owner 

CRU < first owner 

Description 

The record that is the current of run unit becomes the new 
current member of set-1. The first owner connected to the new 
current member of set-1 becomes the new current owner of set-1 
and the current of run unit. If the current member of set-1 has 
no owners via set-1, then the current of run unit becomes null, 
the current owner of set-1 becomes null, and a command status of 
255 is returned. If the user does not have read access to set-1, 
a command status error is returned and no currency indicators are 
changed. 
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Examples of Command Usage 


block/direct 

EO 

= SMC 

( "set- 

-1") 

block/indirect ... 

EO 

= DMS 

( "SMCi 

. set-1") 

record/direct ... 

EO 

= SMC 

("set- 

-1") 

record/indirect. . . 

EO 

= DMS 

( "SMC, 

- set-1 " ) 


SME Set Member to current of run unit (Exception) SME 


Command and Arguments 
SME, set-1 

Currency Indicators 

Ilsfid: cru Changed: CM(set-i)< cru 

Description 

The record that is the current of run unit becomes the new 
current member of set-1. The current of run unit remains 
unchanged. If a user does not have read access to set-1, the 
current member of set-1 does not change and a command status 
error is returned. If the record type of the current of run unit 
is not a member of set-1, then a command status error is returned 
and the current member of set-1 is unchanged. If a current owner 
for set-1 exists and the record indicated by the current of run 
unit is not' connected to that owner through set-1, then a command 
status error of 12 is returned. 

Examples of Command Usage 


block/direct 

EO 

= SME 

( "set- 

-1") 

block/indirect ... 

EO 

= DMS 

( "SME, 

, set-1") 

record/direct ... 

EO 

= SME 

( "set- 

-1”) 

record/indirect. . . 

EO 

= DMS 

("SME, 

■set-1") 


EMM 


Set Member based on Member 




Command and Arguments 
SMM, set-1, set-2 
Currency Indicators 

Ufifid: CM (set-2) Changed: CM (set-1) <; CM (set-2) 

CO (set-1) < first owner 

CRU < first owner 
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Description 

Set the current member of set-1 to be the same as the current 
member of set-2. This command is valid only if set-1 and set-2 
have the same member record type(s). The first owner of the new 
current member of set-1 becomes the new current owner of set-1 
and the current of run unit. If the new current member of set-1 
has no owners via set-1, then the current owner of set-1 becomes 
null, the current of run unit becomes null and a command status 
of 255 is returned. If a user does not have read access to both 
set-1 and set-2, then a command status error is returned and no 
currency indicators change. 

Examples of Command Usage 

block/direct ... EO = SMM ( "set-1 , set-2 " ) 
block/indirect ... EO = DMS ( "SMM, set-1 , set-2") 
record/direct ... EO = SMM ("set-1, set-2") 
record/indirect... EO = DMS ( "SMM, set-1 , set-2") 


SMU Set Member to Mull SMN 

Command and Arguments 
SMN, set-1 

Currency Indicators 

‘Used: none Changed: CM (set-1) < null 

Description 

The current member of set-1 becomes null. The current owner of 
set-1 is unaffected. If a user does not have read access to set- 
1, then the current member of set-1 does not change and a command 
status error is returned. 

Examples of Command Usage 

block/direct ... EO = SMN ("set-1") 
block/indirect ... EO = DMS ( "SMN, set-1") 
record/direct ... EO = SMN ("set-1") 
record/ indirect . . . EO = DMS ( "SMN, set-1") 


SMQ Set Member based on Qwner SMO 

Command and Arguments 
SMO, set-1, set-2 
Currency Indicators 

Hfifid: CO (set-2) ChailSfid: CM (set-1) < CO (set-2) 

CO (set-1) <r first owner 

CRU < first owner 
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Description 

Set the current member of set-1 to be the same as the current 
owner of set-2. This command is valid only if the member recora 
type(s) for set-1 is the same as the owner record type(s) for 
set-2. The first owner of the new current member of set-1 
becomes the new current owner of set-1 and the current of run 
unit. If the new current member of set-1 has no owners via set 
set-1, then the current owner of set-1 becomes null, the current 
of run unit becomes null, and the command status is 255. If a 
user does not have read access to set-1 and set-2, then a command 
status error is returned and no currency indicators change. 

Examples of Command Usage 


block/direct ... 
block/indirect ... 
record/direct ... 
record/ indirect. . . 


EO = SMO 
EO = DMS 
EO = SMO 
EO ■ DMS 


( "set-1 , set-2" ) 
("SMO, set-1, set-2") 
("set-1, set-2") 
("SMO, set-1, set-2") 


sm 


Set Hember based on User indicator 


sun 


Command and Arguments 
SMU, set-1 , iblk 
Currency Indicators 


Used : CU ( i) 


Changed : CM ( set-1 X 

CO (set-1) < 
CRU < 


CU ( i) 

first owner 
first owner 


Description 

Set the current member of set-1 to be the same as the current 
record of a user-defined indicator. The value of the host 
language variable for iblk determines which one of the user- 
defined indicators is involved in this command. The host 
language variable must be consistent with an unsigned data item 
that is one byte in size. The variable's value must be an 
integer between 1 and 255, inclusive. The first owner of the new 
current member of set-1 becomes the new current owner of set-1 
and the current of run unit. If the new current member has no 
owners via set-1, then the current owner of set-1 becomes null, 
the current of run unit become null, and the command status is 
255. The AUI command (Chapter XI) is employed to allocate user- 
defined indicators. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/ indirect .. . EO 


= SMU ("set-1, iblk") 

= DMS ("SMU, set-1, iblk”) 

= SMU ("set-1" , iblk) 

= DMSD ("SMU, set-1" , iblk) 
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SQC S.et Qwner based on Current of run unit SOC 


Command and Arguments 
SOC, set-1 

Currency Indicators 

CRU 

first member 
first member 


Used : CRU 


Changed: 


CO (set-1) < 
CM (set-1) < 
CRU < 


Description 

The record that is the current of run unit becomes the new 
current owner of set-1. The first member connected to the new 
current owner of set-1 becomes the new current member of set-1 
and the current of run unit. If the current owner of set-1 has 
no members via set-1, then the current of run unit becomes null, 
the current member of set-1 becomes null, and a command status of 
255 is returned. If the user does not have read access to set-1, 
a command status error is returned and no currency indicators are 
changed . 

Examples of Command Usage 


block/direct ... EO 
block/ indirect ... EO 
record/direct ... EO 
record/indirect... EO 


SOC (" set-1") 

DMS ("SOC, set-1") 
SOC ("set-1") 

DMS ("SOC, set-1”) 


SQ£ 


Set Owner to current of run unit (Exception) 


SQL. 


Command and Arguments 
SOE, set-1 

Currency Indicators 

Used : CRU Changed : CO (set-1) < CRU 

Description 

The record that is the current of run unit becomes the new 
current owner of set-1. The current of run unit remains 
unchanged. If a user does not have read access to set-1, the 
current owner of set-1 does not change and a command status error 
is returned. If the record type of the current of run unit is 
not an owner of set-1, then a command status error is returned 
and the current owner of set-1 is unchanged. If a current member 
for set-1 exists and the record indicated by the current of run 
unit is not connected to that member through set-1, then a 
command status error of 12 is returned. 
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Examples of Command Usage 


block/direct 

EO 

= SOE 

( "set- 

-1") 

block/indirect . . . 

EO 

= DMS 

( "SOE, 

•set-1") 

record/direct ... 

EO 

= SOE 

( "set- 

•1") 

record/indirect. . . 

EO 

= DMS 

("SOE, 

• set-1") 


SOM Set Qwner based on Member SQJH 


Command and Arguments 
SOM, set-1, set-2 
Currency Indicators 

Used: CM (set-2) Changed: CO (set-1) <■ CM (set-2) 

CM (set-1) < first member 

CRU 4 first member 

Description 

Set the current owner of set-1 to be the same as the current 
member of set-2. This command is valid only if the owner record 
type(s) for set-1 is the same as the member record type(s) for 
set-2. The first member of the new current owner of set-1 
becomes the new current member of set-1 and the current of run 
unit. If the new current owner of set-1 has no members via set 
set-1, then the current member of set-1 becomes null, the current 
of run unit becomes null and the command status is 255. If a 
user does not have read access to set-1 and set-2, then a command 
status error is returned and no currency indicators change. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= SOM ("set-1, set-2") 

= DMS ("SOM, set-1, set-2") 
= SOM ("set-1, set-2") 

= DMS ("SOM, set-1, set-2") 


sou 


Set Qwner to Null 


SON 


Command and Arguments 
SON, set-1 

Currency Indicators 

Used: none Changed: CO (set-1) < null 
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Description 

The current owner of set-1 becomes null. The current member of 
set-1 is unaffected. If a user does not have read access to set- 
1, then the current owner of set-1 does not change and a command 
status error is returned. 

Examples of Command Usage 


block/direct 

EO 

= SON 

( "set- 

•1") 

block/indirect ... 

EO 

= DMS 

( "SON, 

set-1") 

record/direct 

EO 

= SON 

( "set- 

■1") 

record/ indirect . . . 

EO 

= DMS 

("SON, 

set-1 " ) 


SOQ Set Qwner based on Qwner SOO 

Command and Arguments 
SOO, set-1 , set-2 
Currency Indicators 

Used: CO (set-2) Changed: CO (set-1) < CO (set-2) 

CM(set-l)< first member 

CRU < first member 

Description 

Set the current owner of set-1 to be the same as the current 
owner of set-2. This command is valid only if set-1 and set-2 
have the same owner record type(s). The first member of the new 
current owner of set-1 becomes the new current member of set-1 
and the current of run unit. If the new current owner of set-1 
has no members via set-1, then the current member of set-1 
becomes null, the current of run unit becomes null, and a command 
status of 255 is returned. If a user does not have read access 
to both set-1 and set-2, then a command status error is returned 
and no currency indicators change. 


Examples of Command Usage 


block/direct 

EO 

= SOO 

block/indirect ... 

EO 

= DMS 

record/direct ... 

EO 

= SOO 

record/indirect. . . 

EO 

= DMS 


( "set-1 , set-2 " ) 
("SOO, set-1, set-2") 
( "set-1 , set-2 " ) 

( "SOO, set-1 , set-2" ) 
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SOU Set Qwner based on User indicator SOU 


Command and Arguments 
SOU, set-1, iblk 
Currency Indicators 

Used: CU(i) Claused: CO (set-1) < CU(i) 

CM (set-1) < first member 

CRU < first member 

Description 

Set the current owner of set-1 to be the same as the current 
record of a user-defined indicator. The value of the host 
language variable for iblk determines which one of the user- 
defined indicators is involved in this command. The host 
language variable must be consistent with an unsigned data item 
that is one byte in size. The variable's value must be an 
integer between 1 and 255, inclusive. The first member of the 
new current owner of set-1 becomes the new current member of set- 
1 and the current of run unit. If the new current owner has no 
members via set-1, then the current member of set-1 becomes null, 
the current of run unit becomes null, and the command status is 
255. The AUI command (Chapter XI) is employed to allocate user- 
defined indicators. 

Examples of Command Usage 

block/direct ... EO = SOU ( "set-1 , iblk") 
block/indirect ... EO = DMS ( "SOU, set-1 , iblk") 
record/direct ... EO = SOU ( "set-1 ", iblk) 
record/indirect... EO = DMSD ( "SOU, set-1 ", iblk) 


SUC Set User indicator to Current of run unit SUC 

Command and Arguments 
SUC, iblk 

Currency Indicators 

Used: cru Chansfid: CU(i)« CRU 

Description 

Set the current record of a user-defined indicator to be the same 
as the current of run unit. The value of the host language 
variable for iblk determines which one of the user-defined 
indicators is involved in this command. The host language 
variable must be consistent with an unsigned data item that is 
one byte in size. The variable's value must be an integer 
between 1 and 255, inclusive. The AUI command (Chapter XI) is 
employed to allocate user-defined indicators. 
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Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


SUC ( "iblk") 

DMS ("SUC, iblk") 
SUC (iblk) 

DMSD ("SUC", iblk) 


sun 


Set User indicator to Member 


sms 


Command and Arguments 
SUM, set-1, iblk 


Currency Indicators 

Used: CM (set-1) Changed: CU(i)< CM (set-1) 

Description 

Set the current record of a user-defined indicator to be the same 
as the current member of set-1. The value of the host language 
variable for iblk determines which one of the user-defined 
indicators is involved in this command. The host language 
variable must be consistent with an unsigned data item that is 
one byte in size. The variable's value must be an integer 
between 1 and 255, inclusive. The AUI command (Chapter XI) is 
employed to allocate user-defined indicators. 


If a user does not have read access to set-1, no currency 
indicator changes and a command status error is returned. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= SUM ( "set-1 , iblk") 

= DMS ("SUM, set-1, iblk") 

= SUM ("set-1", iblk) 

= DMSD ("SUM, set-1", iblk) 


SQM 


Set User indicator to Null 


sxm 


Command and Arguments 
SUN, iblk 

Currency Indicators 

Used: none ChaDSfid: CU(i)< -null 
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Description 

Set the current record of a user-defined indicator to be null. 
The value of the host language variable for iblk determines which 
one of the user-defined indicators is involved in this command. 
The host language variable must be consistent with an unsigned 
data item that is one byte in size. The variable's value must be 
an integer between 1 and 255, inclusive. The AUI command 
(Chapter XI) is employed to allocate user-defined indicators. 


Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


SUN ("iblk") 

DMS ("SUN, iblk") 
SUN (iblk) 

DMSD ("SUN", iblk) 


SHQ 


Set User indicator to Qwner 


SOD 


Command and Arguments 
SUO, set-1, iblk 


Currency Indicators 

USfid: CO (set-1) Chaussd: CU(i)< CO (set-1) 


Description 

Set the current record of a user-defined indicator to be the same 
as the current owner of set-1. The value of the host language 
variable for iblk determines which one of the user-defined 
indicators is involved in this command. The host language 
variable must be consistent with an unsigned data item that is 
one byte in size. The variable's value must be an integer 
between 1 and 255 , inclusive. The AUI command (Chapter XI) is 
employed to allocate user-defined indicators. 


If a user does not have read access to set-1, no currency 
indicator changes and a command status error is returned. 

Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


SUO ("set-1, iblk") 

DMS ("SUO, set-1, iblk") 
SUO ( "set-1 ", iblk) 

DMSD ("SUO, set-1", iblk) 
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SHU 


Set User indicator to User indicator 


sun 


Command and Arguments 
SUU, iblk 

Currency Indicators 

Used: cu(j) Changed: cu(i)< cu(j) 

Description 

Two host language variables, say i and j, are defined for iblk. 
Each must be consistent with an unsigned data item that is one 
byte in size. Each must have an integer value between 1 and 255, 
inclusive. This command sets the current record of a user- 
defined indicator (determined by i's value) to be the same as the 
current record of another user-defined indicator (determined by 
j's value). The AUI command (Chapter XI) is employed to allocate 
user-defined indicators. 


Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/ indirect . . . EO 


SUU ("iblk") 

DMS ("SUU, iblk") 
SUU (iblk) 

DMSD ("SUU", iblk) 
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VII. CREATION COMMANDS 


A. Overview 

There are two MDBS DML commands that can be used to create a 
record occurrence. One forces MDBS. DMS to create the record in a 
particular desired area, indicated by a command argument. However, 
the record cannot be forced into an area it was not assigned to in the 
DDL specification. This command cannot be used with a record type that 
has a calc key. 

The other creation command allows MDBS. DMS to place the new 
record in any area it was assigned to in the DDL specification. If a 
CALC or clustering record location mode was defined for the record in 
the DDL, then MDBS. DMS physically positions the new record 
accordingly. In the case of clustering, the new member (owner) record 
is clustered on the basis of the current owner (current member) of the 
set indicated in that record type's clustering clause (as specified in 
the DDL) . 

Data to be stored in the new record is transferred from the host 
language variables of a data block (or program record type) in to the 
data base. The types, sizes and sequence of these variables must be 
consistent with the types, sizes and sequences of the record type's 
data items as specified in the DDL. The values of these variables 
must conform to the feasibility ranges specified for the record type's 
data items in the DDL specification. If they do not, the record is 
not created and a command status error is returned. Data compression 
and encryption are automatic, where applicable. 

A record can be created only if the user has write access to all 
data items of that record type, write access to the area in which that 
record is to be created, and write access to all sets in which that 
record type participates as an automatic owner or member. In the 
event that there is no space left, in the area(s) in which MDBS. DMS is 
permitted to create an occurrence of the record type, a command status 
error to that effect is returned. 

If a data base has multiple areas, then all areas which permit 
pointer indices must be on-line during record creation. 
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B. Command Details 

££A Create Record in Area cra 


Command and Arguments 
CRA, rec, area, iblk 
Currency Indicators 

ILSfid: Changed: CRU< newly created record 


...if rec is AUTO 

...if rec is AUTO 




member of set 

member of set 




CO (auto set) 

CM (auto set) <— 

— newly 

created 

record 

. . . if rec is AUTO 

...if rec is AUTO 




owner of set 

owner of set 




CM (autoset) 

CO (autose t)« — 

— newly 

created 

record 


Description 

An occurrence of the record type rec is created in the indicated 
area. The values of the host language variables for iblk are 
stored into that record occurrence. The sequence,, types, and 
sizes of host language variables defined for iblk must correspond 
to the sequence, types, and sizes of data items defined for rec 
in the DDL specification. The values of the variables must 
conform to feasibility ranges specified for the record type's 
data items. If they do not, a command status error is returned, 
the record is not created, and no currency indicators change. 

The physical placement of the newly created record is consistent 
with the DDL specification for rec (either clustered or system- 
determined). A record with a calc key cannot be created with CRA. 
In order to create a record with CRA, a user must have write 
access to rec, to the area in which the record is to be created, 
and to all sets in which the record type participates as an 
automatic owner or member. If a user does not have this security 
clearance, a command status error is returned, the record is not 
created, and no currency indicator is changed. 

If rec has been declared to be the AUTO member of a set, then the 
newly created record is automatically connected to the current 
owner of that set and the new record becomes the current member 
of that set. The connection takes place according to the member 
order specified with the DDL (SORTED, FIFO, etc.). If the member 
order for the set is NEXT, then the new record is connected 
(i.e., logically inserted) immediately after the set's current 
member. If there is no current member, the record is inserted as 
the first member. For PRIOR member order, the new record is 
logically connected immediately before the set's current member. 
If there is no current member, the record is inserted as the last 
member . 
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If rec has been declared to be the AUTO owner of a set, then the 
newly created record is automatically connected to the current 
member of that set and the new record becomes the current owner 
of that set. The connection occurs according to the set's owner 
order, as specified with the DDL (SORTED, LIFO, NEXT, etc.). If 
the owner order for the set is NEXT (or PRIOR), then the new 
record is logically connected immediately after (or before) the 
set's current owner. If there is no current owner, the record is 
inserted as the first (last) owner. 

Examples of Command Usage 

block/direct ... EO = CRA ("rec, area, iblk") 
block/indirect ... EO = DMS ( "CRA, rec , area , iblk" ) 
record/direct ... EO = CRA ( "rec, area", iblk) 
record/indirect... EO = DMSD ( "CRA, rec , area ", iblk) 


CRS Create Record and Store CRS 


Command and Arguments 
CRS, rec, iblk 
Currency Indicators 

Used: Changed: CRU< newly created record 

...if rec is AUTO ...if rec is AUTO 

member of set member of set 

CO (auto set) CM (auto set) < newly created 

...if rec is AUTO ...if rec is AUTO 

owner of set owner of set 

CM(autoset) CO (autoset )< newly created 


Description 

An occurrence of the record type rec is created in a permissible 
area. The values of the host language variables for iblk are 
stored into that record occurrence. The sequence, types, and 
sizes of host language variables defined for iblk must correspond 
to the sequence, types, and sizes of data items defined for rec 
in the DDL specification. The values of the variables must 
conform to feasibility ranges specified for the record type's 
data items. If they do not, a command status error is returned, 
the record is not created, and no currency indicators change. 

The physical placement of the newly created record is consistent 
with the DDL specification for rec (either CALCed, clustered, or 
system-determined). In order to create the record, a user must 
have write access to rec, to the area in which the record is to 
be created, and to all sets in which the record type participates 


record 


record 
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as an automatic owner or member. If a user does not have this 
security clearance, a command status error is returned, the 
record is not created, and no currency indicator is changed. 

If rec has been declared to be the AUTO member of a set, then the 
newly created record is automatically connected to the current 
owner of that set and the new record becomes the current member 
of that set. The connection takes place according to the member 
order specified with the DDL (SORTED, FIFO, etc.). If the member 
order for the set is NEXT, then the new record is connected 
(i.e., logically inserted) immediately after the set's current 
member. If there is no current member, the record is inserted as 
the first member. For PRIOR member order, the new record is 
logically connected immediately before the set's current member. 
If there is no current member, the record is inserted as the last 
member . 


If rec has been declared to be the AUTO owner of a set, then the 
newly created record is automatically connected to the current 
member of that set and the new record becomes the current owner 
of that set. The connection occurs according to the set's owner 
order, as specified with the DDL (SORTED, LIFO, NEXT, etc.). If 
the owner order for the set is NEXT (or PRIOR), then the new 
record is logically connected immediately after (or before) the 
set's current owner. If there is no current owner, the record is 
inserted as the first (last) owner. 


Examples of Command Usage 


block/direct 

EG 

= CRS 

block/indirect ... 

EO 

= DMS 

record/direct 

EO 

= CRS 

record/indirect. . . 

EO 

= DMSD 


( 

( 

( 


"rec, iblk") 
"CRS,rec,iblk") 
"rec", iblk) 
("CRS, rec", iblk) 
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VIII. CONNECT COMMANDS 


A. Overview 

The MDBS connect commands allow two record occurrences to be 
connected to each other through a set relationship. The record that 
is the current of run unit becomes connected to the current owner of 
an indicated set or the current member of an indicated set, depending 
on which connect command is used. When a record is connected as a 
member (owner), it is inserted into a set relationship on the basis of 
that set's member (owner) order. During record connection, all areas 
allowing pointer indices must be on-line. 

Connection commands are used to accomplish the manual insertion 
of a record into a set relationship. This is typically needed in 
cases where a) MANUAL set insertion has been defined for a set's owner 
or member record type, b) AUTO set insertion has been declared in the 
DDL for both the owner and member record types of an N : M set, c) it is 
necessary to reconnect a record (perhaps, to a different owner or 
member record) after it has been disconnected. 

In the MANUAL case, the creation of a member (owner) record does 
not automatically connect it to an owner (member) record of the set. 
If and when such a connection is desired, it is accomplished with a 
connect command. In the second case, suppose that a member (owner) 
record of an N : M set is created. It is automatically connected to one 
owner (member) record. If it is desired to connect it to additional 
owner (member) records, a connect command is used. In the third case, 
it is sometimes important to disconnect a member (owner) from an owner 
(member) and later connect that member (owner) to the same or a dif- 
ferent owner (member). Regardless of whether there is AUTO or MANUAL 
set insertion, this reconnection is accomplished by a connect command. 

The integrity of all set relationships is preserved. A command 
status error results if an attempt is made to connect a member with 
more than one owner in a 1:1 or 1:N set, to connect an owner with more 
than one member of 1:1 or N:1 set, or to connect a member with an 
owner to which it is already connected. 

If a user does not have write access to the set involved in a 
connect command, the connection does not take place and a command 
status error to that effect is returned. 

B. Command Details 

IMS Insert Member into Set IMS 

Command and Arguments 

IMS, set-1 

Currency Indicators 

Used: co (set-1) Changed : CM(set-l)« CRU 

CRU 
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Description 

The record that is current of run unit becomes connected to the 
current owner of set-1. This new member for the current owner of 
set-1 is made the current member of set-1. The insertion of this 
new member record among the existing member records, connected to 
the current owner of set-1, is made in accordance with the member 
order declared for set-1 in the DDL specification. If the member 
order is NEXT (or PRIOR) then the new member is logically 
inserted after (or before) the set’s current member; if the set 
has no current member, the record is logically inserted as the 
first (or last) member. 

If multiple owners can exist for this new member, the record that 
is the current owner is logically inserted into those owners 
according to the owner order of set-1. The exception is if the 
owner order is NEXT (or PRIOR), in which case the record that is 
the current owner becomes the logically first (or last) owner of 
the set's new current member. 

The current of run unit must be an occurrence of a record type 
that is a member of set-1. A user must have write access to set- 
1, in order to connect a member record to an owner record. 

Examples of Command Usage 

block/direct ... EO = IMS ("set-1") 
block/indirect ... EO = DMS ( "IMS, set-1") 
record/direct ... EO = IMS ("set-1") 
record/indirect... EO = DMS ( "IMS, set-1") 


IQS Insert Qwner into Set IQS 


Command and Arguments 
IOS, set-1 

Currency Indicators 

Used: cm (set-l) Changed: co (set-l) < -cru 

cru 

Description 

The record that is current of run unit becomes connected to the 
current member of set-l. This new owner for the current member 
of set-l is made the current owner of set-l. The insertion of 
this new owner record among the existing owner records, connected 
to the current member of set-l, is made in accordance with the 
owner order declared for set-l in the DDL specification. If the 
owner order is NEXT (or PRIOR) then the new owner is logically 
inserted after (or before) the set's current owner; if the set 
has no current owner, the record is logically inserted as the 
first (or last) owner. 
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If multiple members can exist for this new owner, the record that 
is the current member is logically inserted into those members 
according to the member order of set-1. The exception is if the 
member order is NEXT (or PRIOR), in which case the record that is 
the current member becomes the logically first (or last) member 
of the set's new current owner. 

The current of run unit must be an occurrence of a record type 
that is a owner of set-1. A user must have write access to set- 
1, in order to connect an owner record to a member record. 


Examples of Command Usage 


block/direct 

EO 

= IOS 

( "set- 

■1") 

block/indirect ... 

EO 

= DMS 

( "IOS, 

-set-1") 

record/direct ... 

EO 

= IOS 

( "set- 

-l n ) 

record/indirect. . . 

EO 

= DMS 

( n IOS, 

, set-1") 
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IX. DISCONNECT COMMANDS 


A. Overview 

The MDBS DML disconnect commands allow an owner record and a 
member record that are connected via a set to be disconnected from 
each other. Either the current member or all members can be 
disconnected from a set's current owner. Similarly, either the 
current owner or all owners can be disconnected from a set's current 
member. Removing a set connection between two occurrences does not 
delete those occurrences from the data base. 

If a set has fixed retention, no disconnections can be made for 
it; in this case, a record must be deleted to be disconnected. If a 
user does not have write access for a set, then that user cannot 
perform any disconnections on that set. During disconnection all 
areas allowing pointer indices must be on-line. 


B. Command Details 


BMS Remove Member from Set BMS 


Command and Arguments 
RMS, set-1 

Currency Indicators 

USfid: CM(set-l) Changed: CM(set-l)^ next member 

CO (set-1) CRU < next member 

Description 

Remove the connection between the current owner and current 
member of set-1. The next member (following the member that was 
removed) of the current owner of set-1 becomes the new current 
member of set-1 and the current of run unit. Which member is 
logically next depends on the member order of set-1, as declared 
in the DDL specification. If there is no next member, the 
current member indicator for set-1 becomes null, the current of 
run unit becomes null, and the command status is 255. If a user 
does not have write access to set-1, then the current member is 
not disconnected, no currency indicators change, and a command 
status error is returned. 

Examples of Command Usage 


block/direct 

EO 

= RMS 

( "set- 

■1") 

block/indirect ... 

EO 

= DMS 

( "RMS i 

■set-1") 

record/direct 

EO 

= RMS 

( "set- 

-1") 

record/indirect. . . 

EO 

= DMS 

( "RMS, 

, set-1") 
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EDS 


Remove Qwner from Set 


EOS 


Command and Arguments 
ROS, set-1 

Currency Indicators 

Used: CO (set-1) Changed: CO (set-1) < next owner 

CM (set-1) CRU < next owner 


Description 

Remove the connection between the current member and current 
owner of set-1. The next owner (following the owner that was 
removed) of the current member of set-1 becomes the new current 
owner of set-1 and the current of run unit. Which owner is 
logically next depends on the owner order of set-1, as declared 
in the DDL specification. If there is no next owner, the current 
owner indicator for set-1 becomes null, the current of run unit 
becomes null, and the command status is 255. If a user does not 
have write access to set-1, then the current owner is not 
disconnected, no currency indicators change, and a command status 
error is returned. 

Examples of Command Usage 


block/direct ... 

E0 

= ROS 

( "set- 

*1") 

block/indirect . . . 

E0 

■ DMS 

("ROS, 

- set-1 ") 

record/direct ... 

E0 

= ROS 

( "set- 

■1") 

record/indirect. . . 

E0 

= DMS 

( "ROS, 

- set-1") 


BSE 


Remove all Set Members 


RSM 


Command and Arguments 
RSM, set-1 

Currency Indicators 

Ilssd: CO (set-1) Changed: CM(set-l)« null 

Description 

Remove the connection between the current owner of set-1 and each 
one of its members. The current member of set-1 becomes null. 
If a user does not have write access to set-1, then the members 
are not disconnected, the current member of set-1 does not 
change, and a command status error is returned. 
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Examples of Command Usage 

block/direct ... EO = RSM ("set-1") 
block/indirect ... EO = DMS ( "RSM, set-1") 
record/direct ... EO = RSM ("set-1") 
record/indirect... EO = DMS ( "RSM, set-1") 


RSO Remove all Set Owners RSQ 


Command and Arguments 
RSO, set-1 

Currency Indicators 

IlSfid: CM (set-1) Changed: CO (set-1) « null 

Description 

Remove the connection between the current member of set-1 and 
each one of its owners. The current owner of set-1 becomes null. 
If a user does not have write access to set-1, then the owners 
are not disconnected, the current owner of set-1 does not change, 
and a command status error is returned. 

Examples of Command Usage 

block/direct ... EO = RSO ("set-1") 
block/indirect ... EO = DMS ( "RSO, set-1" ) 
record/direct ... EO = RSO ("set-1") 
record/indirect... EO = DMS ( "RSO, set-1") 
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X. DELETION COMMANDS 


A. Overview 

Each of the three MDBS DM L deletion commands deletes a record 
occurrence from the data base. A record must have been found before 
it can be deleted. Thus there are commands to delete the record that 
is the 

current of run unit, 

current owner of an indicated set, or 

current member of an indicated set. 

A record that has been remembered in a user-defined indicator can also 
be deleted, after first making it the current of run unit, a current 
owner, or a current member (with an assignment command). 

When a record is deleted, MDBS. DMS disconnects it from every 
record that owns it and from every member record that it owns. The 
space occupied by that record is nulled and is returned to the pool of 
free space, so that it can later be reused by MDBS. DMS. Deletion 
commands can have extensive effects on currency indicators. 

A user is not allowed to delete a record without write access to 
all of the record type's data items, write access to all sets in which 
that record type participates, and write access to the area containing 
the record and all areas containing records connected to the record 
being deleted. An attempt to violate these security constraints does 
not affect the record and it results in a command status error. 

In the case of multiple areas, all areas that can contain pointer 
indices must be on-line for record deletion. 


B. Command Details 


DEC 


Delete Becord that is Current of run unit 


DEC 


Command and Arguments 

DRC (no argument) 

Currency Indicators 

Used: cru Changed: cru« null 

also see description 

Description 

The record that is the current of run unit is disconnected from 
all set relationships and is physically deleted from the data 
base. The current of run unit becomes null. If the deleted 
record is the current owner of any set, the current member of any 
set, or the current record of any user-defined indicator, then 
those indicators become null. If a user does not have write 
access to the current of run unit's record type, to the record's 
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area and to all sets in which that record type participates, then 
no deletion occurs, no currency indicator changes, and a command 
status error is returned. 


Examples of Command 

Usage 


block/direct 

... EO 

= DRC 

block/indirect 

... EO 

= DMS 

record/direct 

... EO 

= DRC 

record/ indirect 

... EO 

= DMS 

DBM 

Delete 

Recor 


( ) 

("DRC") 
( ) 
("DRC") 


that is Member 


DBM 


Command and Arguments 
DRM, set-1 

Currency Indicators 

Used: CO (set-1) Chansfid: CM (set-1 ) < next member 

CM (set-1) CRU 4- -next member 

also see description 

Description 

The record that is the current member of set-1 is disconnected 
from all set relationships and is physically deleted from the 
data base. The next member that is owned by the current owner of 
set-1 becomes the current member of set-1 and the current of run 
unit. Which member is next depends on the member order of set-1. 
If there is no next member, then the current of run unit becomes 
null the current member of set-1 becomes null, and the command 
status is 255. If the record being deleted is the current owner 
of any set, the current member of any set other than set-1, or 
the current record of any user-defined indicator, then those 
indicators become null. 


If the user does not have write access to set-l's member record 
type, to the record's area and to all sets in which that record 
tyP e participates, then no deletion occurs, no currency indicator 
changes, and a command status error is returned. 


Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


DRM ( "set-1") 

DMS ("DRM, set-1") 
DRM ("set-1") 

DMS ("DRM, set-1") 
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DBQ 


Delete Record that is Qwner 


DBQ 


Command and Arguments 
DRO, set-1 

Currency Indicators 

Used: CM (set-1) Changed: CO (set-1) < next owner 

CO (set-1) CRU < next owner 

also see description 


Description 

The record that is the current owner of set-1 is disconnected 
from all set relationships and is physically deleted from the 
data base. The next owner that is owned by the current member of 
set-1 becomes the current owner of set-1 and the current of run 
unit. Which owner is next depends on the owner order of set-1. 
If there is no next owner, then the current of run unit becomes 
null, the current owner of set-1 becomes null, and the command 
status is 255. If the record being deleted is the current member 
of any set, the current owner of any set other than set-1, or the 
current record of any user-defined indicator, then those 
indicators become null. 

If the user does not have write access to set-l's owner record 
type and to all sets in which that record type participates, then 
no deletion occurs, no currency indicator changes, and a command 
status error is returned. 

Examples of Command Usage 


block/direct 

EO 

= DRO 

( "set- 

-1") 

block/indirect . . . 

EO 

= DMS 

("DRO, 

. set-1 " ) 

record/direct ... 

EO 

= DRO 

( "set- 

-1") 

record/indirect. . . 

EO 

= DMS 

( "DRO, 

. set-1 " ) 
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XI. UTILITY COMMANDS 


A. Overview 

Utility commands fall into the following groups: 

1. Opening and closing a database or database area 

DBCLS, DBCL SA f DBOPN, DBOPN A 

2. Flushing the page buffers 

DBSAVE 

3. Allocating user-defined indicators 

AUI 

4. Getting the owner (member) count for a member (owner) 

GMC,GOC 

5. Getting the type of a record occurrence 

GTC,GTM,GTO 

6. Testing for the type of a record occurrence and checking for 
the equality of currency indicators 

TCT, CCU, TMT,TOT 

7. Acquiring database statistics 

DBSTAT 

8. Nulling all currency indicators 

NCI 

9. Customizing the data base control system's behavior 

DBCNV, DBENV 


B. Command Details 


AUI 


Allocate User indicators 


AUI 


Command and Arguments 
AUI, iblk 

Currency Indicators 

Used : none Changed : see description 

Description 

One host language variable is defined for iblk. It must be 
consistent with a one byte unsigned data item. The value of that 
variable must be between 0 and 255, inclusive. This value tells 
MDBS. DMS how many user-defined indicators are to be allocated. 
If the value is 0, then no user-defined indicators are allocated. 
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If the value is 12, then user indicators 1 through 12 are 
allocated. If the value is 139, the user indicators 1 through 
139 are allocated. 

AUI can be invoked repeatedly within an application program to 
increase or decrease the number of user-defined indicators, as 
desired. When a data base is opened for data manipulation (with 
the DBOPN command) , four user-defined indicators are 
automatically allocated and set to null. These first two user 
indicators (1,2) are needed when performing a Boolean DML 
command. If an application program does not use a Boolean 
command and does not need any user indicator, the AUI can be used 
to allocate zero user indicators. If more than four user 
indicators are needed, AUI is used to allocate the desired 
number. When AUI is employed to increase the number of user 
indicators, the records that were current for already allocated 
user indicators are still current. The new indicators are set to 
null. When AUI is employed to decrease the number of user 
indicators, only those records that are current for the resultant 
user indicators are still current. For instance, if ten user 
indicators are allocated and AUI is used to reduce this to five, 
then only those records that were current for user indicators 1 
through 5 are still current after invoking AUI. Knowledge about 
which records were current for user indicators 6 through 10 is 
not maintained. 

Examples of Command Usage 

block/direct ... E0 * AUI ("iblk") 
block/indirect ... E0 * DMS ("AUI, iblk") 
record/direct ... E0 = AUI (iblk) 
record/indirect... EG = DMSD ("AUI", iblk) 


ecu £heck Current of run unit against User indicator CCU 

Command and Arguments 
CCU, iblk 

Currency Indicators 

Used : CRU Chanced : none 

CU ( i) 

Description 

Check to determine whether the record that is current for a user- 
defined indicator is the same record that is the current of run 
unit. The value of iblk's host language variable determines the 
user indicator for which this check is made. That variable must 
be consistent with a one byte, unsigned data item. If the 
current of run unit is the same record as the specified user 
indicator, then the command status is 0. If it is not, then the 
command status is 255. 
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Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/ indirect. . . EO 


CCU ("iblk") 

DMS ("CCU, iblk") 
CCU (iblk) 

DMSD ("CCU", iblk) 


nBCT.s .Data Base £Lo£e DBCLS 

Command and Arguments 

DBCLS (no arguments) 

Currency Indicators 

Used : none Changed : all4 —null 

Description 

In a sinale-user environment . DBCLS should be the last DML 
command invoked in an application program. DBCLS nulls all of 
that program's currency indicators, eliminates all of the 
program's user indicators, flushes the page buffers (i.e., 
rewrites all pages, that have changed since entering main memory, 
into auxiliary memory) , and performs a TRCOM (for the RTL form of 
the system) . No further data manipulation can be performed after 
DBCLS, until the data base is reopened (with DBOPN) . 


Failure to close a data base can leave its contents inconsistent, 
if the data base was opened for modification. This inconsistency 
will prevent subsequent efforts to open the data base. The data 
base can be restored to a consistent state with the MDBS RCV 
utility. 


In a multi-user env ironment . many application programs share the 
same page buffers. Invoking DBCLS within an application program 
nulls out all of that program's currency indicators and 
eliminates all of the program's user indicators. It will also 
flush the page buffers if no other application program currently 
has the data base open for processing. In order to flush the 
page buffers, irrespective of whether other programs have the 
data base open for processing, the DBSAVE command should be used. 
An application program can perform no further data manipulation 
after it has invoked DBCLS, until it reopens the data base (with 
DBOPN) . 


Examples and Command Usage 


block/direct ... 
block/indirect ... 
record/direct 
record/ indirect . . . 


EO = DBCLS ( ) 
EO = DMS ("DBCLS”) 
EO = DBCLS ( ) 
EO = DMS ("DBCLS") 
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DBCLSA 


.Data Base £Lo£e for Area 


DBCLSA 


Command and Arguments 


DBCLSA, area 
Currency Indicators 

Used : none Changed : none 

Description 

DBCLSA flushes all page buffers that contain pages from the 
indicated area. "Flush" means to rewrite pages, that have 
changed since entering main memory, into auxiliary memory. A 
user must have either read or write access to the indicated area 
in order to use this command. The file on which the area resides 
is closed by the operating system. 


Examples of Command Usage 


block/direct ... 
block/indirect ... 
record/direct ... 
record/indirect. . . 


EO « DBCLSA ("area") 

EO = DMS ("DBCLSA, area") 
EO = DBCLSA ("area") 

EO = DMS ("DBCLSA, area") 


DBCNV Data Base format CoNVersion DBCNV 

Command and Arguments 
DBCNV, iblk 
Currency Indicators 

Used : none Changed : none 

Description 

A run unit can use the DBCNV command to cause the data base 
control system to automatically convert date values into an 
alternative format as they are transferred between that run unit 
and a data base. As a value is transferred to a data base, it is 
converted from the alternative format to the standard MDBS format 
(mm/dd/yyyy for date, prior to compression) . Conversely, as a 
value is transferred to the run unit, it is converted from the 
standard MDBS format to the alternative format. 

The desired alternative format is indicated by the value of 
iblk's host language variable. This variable must be consistent 
with a one byte, unsigned data item. The permissible iblk 
variable values and their corresponding formats are: 

1 mm/dd/yyyy (the standard MDBS date format) 

2 dd/mm/yyyy 

3 yyyy/mm/dd 

4 yyyy/dd/mm 
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DBCNV can be invoked multiple times within a run unit to switch 
between various date formats. 

DBCNV can also be used to allow (or disallow) null date or time 

values. The standard MDBS default condition is that null dates 

and null times are not allowed. Additional permissible iblk 
variable values and their effects are. as follows: 

5 null dates are allowed on input 

6 null dates are not allowed on input (default condition) 

7 null times are allowed on input 

8 null times are not allowed on input (default condition) 

Here, "input" refers to any attempt to create or alter the value 

of a date or time data item. If a null date or time is involved 
in a sorted relationship, null values are sequenced after non- 
null values. 


Examples of Command Usage 

block/direct ... 
block/indirect ... 
record/direct ... 
record/indirect ... 


EO = DBCNV ("iblk") 

EO = DMS ("DBCNV, iblk") 
EO = DBCNV (iblk) 

EO » DMSD ("DBCNV", iblk) 


DBENV Data Base ENV ironment options DBENV 

Command and Arguments 
DBENV, iblk 
Currency Indicators 

Used: none Changed : none 

Description 

A run unit can use this command to customize its processing 
environment by specifying how the data base control system should 
behave when interacting with that run unit. The value of iblk's 
host language variable governs which aspect of the environment is 
altered. If the value is 1, 2 or 3 then MDBS. DMS behavior is 
altered for all run units for as long as any of them still has 

the data base open. The host language variable for iblk must be 

consistent with a one byte unsigned data item. Since option 1 
alleviates some of the checking that is otherwise performed by 
MDBS. DMS, it can increase the processing speed of an application 
program that modifies a data base. This option is typically used 
in an application program that is known to be "bug" free. 

If the variable has a value of 1, then MDBS. DMS does not perform 

a check to determine whether a record being connected to an owner 
record for a set is already owned by that owner record via that 
set. 
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If the variable has a value of 2, then checksums on disk reads 
are not suppressed. If the variable has a value of 3, the 
mdbs.dms automatically performs a DBSAVE whenever a DML command 
causes a change to a page(s) in memory. Although these two 
options provide additional integrity safeguards, they will result 
in slower processing. 

If iblk's variable has a value of 4, then no passive lock 
checking will be performed for the run unit that invokes DBENV. 
Though this option results in faster processing of the run unit's 
DML commands, it should be used only with extreme caution because 
it eliminates a significant portion of the built-in integrity 
checking. When its passive lock checking is disabled, the run 
unit will be allowed to alter records that are pasively locked by 
other run units. It will not be allowed to actively lock a 
record that is passively locked by others. The usual record 
deletion and set removal integrity restrictions are still 
enforced (see Table XIV-1). 

If iblk's variable has a value of 5, the run unit's attempts to 
find a record based on a sort key (e.g., with FMSK) will be 
processed in a slightly different way than usual. If a record 
with an indicated sort key value cannot be found (because it does 
not exist), then the pertinent currency indicators (CRU and 
either CO or CM) become null and the command status is 255. 

If the variable has a value of 6, the automatic FFM or FFO that 
is normally carried out for assignment commands (e.g., SOM) is 
not performed. In some situations this allows the run unit's 
control logic to be more concise. 

After DBENV has been invoked to alter some aspect of the 
environment, that aspect of the environment can be restored to 
its default behavior. This is accomplished by invoking DBENV 
again, using a variable value that is 100 greater than what was 
previously used. For instance, if iblk's variable has a value of 
105, then the effect of formerly invoking DBENV with a value of 5 
is no longer in force. If DBENV is invoked with a value of 101, 
102, or 103 then the normal MDBS.DMS behavior is restored for all 
run units. 


Examples of Command Usage 


block/direct ... E0 
block/indirect ... E0 
record/direct ... E0 
record/indirect... E0 


DBENV Ciblk") 

DMS ("DBENV, iblk") 
DBENV (iblk) 

DMSD ("DBENV" , iblk) 
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DBQPIJ Data Base Q£eN DBQPU 

Command and Arguments 
DBOPN,iblk 
Currency Indicators 

USfid: none Changed: CO (system-owned set) 4 system 

CO (other sets) 4 null 

CM (all sets) 4 null 

CRU 4 system 

CU(1) ,CU(2) ,CU(3) ,CU(4) 4 null 

Descr ipt ion 

DBOPN opens a data base for processing by an application program. 
An application program must invoke the DBOPN command tetutfi any 
data held in the data base can be accessed. There are four host 
language variables for the iblk data block (or program record 
type), which MDBS. DMS expects in the following sequence: 

1. The first variable's value is a user's name that has 
been specified in the DDL. This variable must be 
consistent with a string data item of no more than 16 
bytes. 

2. The second variable's value is the user's password as 
specified in the DDL. This variable must be consistent 
with a string data item of no more than 12 bytes. 

3. The third variable's value indicates the type of pro- 
cessing that the program will perform. This variable 
must be consistent with a string data item of no more 
than 4 bytes. If the variable's value begins with R, 
the program is allowed to perform retrieval only (i.e., 
read access only, regardless of a user's write access 
codes). If it begins with M, the program can modify 
(as well as retrieve) data. If the variable's value 
begins with E, the run unit has exclusive modification 
and retrieval access to a data base, subject to 
security constraints; in a multiuser environment this 
prohibits any other application program from accessing 
a data base, until the program with exclusive access 
invokes DBCLS . Since it is not sharing the data base 
with other run units, a run unit with exclusive access 
will execute faster than if it had R or M access. 

4. The fourth variable's value is the fully qualified file 
name for the main area of the data base being opened. 
This variable must be consistent with a string data 
item; the maximum length is operating system dependent. 
It cannot exceed the length of a fully qualified file 
name permitted in the operating system (consult the 
appropriate system specific manual). 
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In block-oriented languages, the iblk data block must be the last 
data block defined (see DEFINE command) before invoking DBOPN. 
This block and all other data blocks defined before invoking 
DBOPN are inoperative after invoking DBOPN. (They must be 
defined again, after DBOPN, in order to be used after DBOPN.) 

Upon opening a data base for processing the current of run unit 
and the current owners of all system-owned sets become the SYSTEM 
record occurrence. All other currency indicators are null. Four 
user-defined currency indicators are automatically allocated. If 
any page images exist on the page-image file, they are used to 
automatically restore data base consistency. The page-image file 
must have been delcared with the PIFD command (Chapter XV) prior 
to invoking DBOPN. For the RTL form, a command status warning of 
74 is returned if no log file is present; this does not prevent 
the data base from being opened. 

Although DBOPN opens only the main area of the data base, other 
areas are automatically opened by MDBS.DMS when the application 
program needs to access records in those areas. These are opened 
for the same type of processing as the main area. A command 
status error results if an area that needs to be automatically 
opened is not on-line. A command status error results if the 
user does not have read access or write access to the area that 
needs to be opened. 

Examples and Command Usage 

block/direct ... EO = DBOPN ("iblk") 
block/indirect ... EO = CALL DMS ( "DBOPN, iblk " ) 
record/direct ... EO = DBOPN (iblk) 
record/ indirect .. . EO = CALL DMSD ( "DBOPN" , iblk) 


D BOPNA Data Ease QPeN Area DBQPN& 


Command and Arguments 
DBOPNA, area, iblk 
Currency Indicators 

Used: none Changed: none 
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Description 

DBOPNA explicitly opens the indicated area for processing. 
MDBS. DMS expects to find this area on the file indicated by the 
value of iblk's host language variable. This variable must be 
consistent with a string data item; its size is operating system 
dependent, but cannot exceed the maximum length of a fully 
qualified file name allowed by the host operating system (consult 
the pertinent system specific manual). The value of the variable 
must be the fully qualified name of a file that is on-line when 
DBOPNA is invoked. This name does not need to match the file 
name assigned to the area in the DDL specifications. If the 
indicated file is not on-line, a command status of 54 is 
returned. This fact can be used by the application developer to 
determine whether an end user of the application program has the 
appropriate disks on-line; if they are not, a corresponding 
prompt can be issued to the end user. 

If iblk's host language variable has a null value, then MDBS. DMS 
assumes that the area exists on the file specified for that area 
in the DDL specifications (or its default name, if none is 
specified) . 


Examples and Command Usage 


block/direct ... EO 

block/indirect ... EO 

record/direct ... EO 
record/indirect... EO 


DBOPNA ("area, iblk") 
or EO = DBOPNA ("area") 

DMS ("DBOPNA, area, iblk") 
or EO = DMS ( "DBOPNA, area") 
DBOPNA ("area", iblk) 

CALL DMSD ( "DBOPNA, area ", iblk) 


BB2AYE Data Ease SAVE DBSAVE 

Command and Arguments 

DBSAVE (no arguments) 

Currency Indicators 

Used: none Changed: none 

Description 

DBSAVE flushes the page buffers, regardless of whether the run 
unit is executing in a single-user or multiuser environment. 
This saves all changes that have been made to pages (in the page 
buffers) since they entered main memory. These changed pages are 
saved by rewriting them into the data base that exists in aux- 
iliary memory. It is advisable to invoke DBSAVE after extremely 
crucial transactions that change data base contents. This 
guarantees that those transactions are immediately incorporated 
into the permanent copy of a data base. In the event of an 
abnormal interruption of a run unit, the following rule holds. 
If no changes have been made to the data base since the last 
DBSAVE, then the data base is consistent and can be re-opened 
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successfully (i.e., without a command status error of 15). In a 
multiuser environment, the data base control system may 
automatically invoke DBSAVE many times, independently of any 
executing run unit. Thus an abnormal interruption may still 
leave the data base in a consistent state so that it can be 
successfully re-opened. 

Examples of Command Usage 

block/direct ... EO = DBSAVE ( ) 
block/indirect ... EO = DMS ("DBSAVE") 
record/direct ... EO = DBSAVE ( ) 
record/indirect... EO = DMS ("DBSAVE") 


DBSTAT Data Base SlAIistics DBSTAT 

Command and Arguments 
DBSTAT, oblk 
Currency Indicators 

LLSfid: none ChADSfid: none 

Description 

Statistics on data base utilization are returned as values of 
oblk's five host langugage variables. Each of these variables 
must be consistent with a two byte, unsigned data item. The 
sequence of the five returned statistics is as follows: 

1. the number of page buffers currently allocated in main 
memory, 

2. the number of times (since opening the data base) that 
the most recent page access was to a different page 
than the last page access, 

3. the number of read requests issued by MDBS. DMS since 
opening the data base, 

4. the number of write requests issued since the data base 
was opened that were due to DBSAVE or to background 
processing in a multiuser environment, 

5. the total number of write requests issued by MDBS. DMS 
since opening the data base. 

Examples of Command Usage 

block/direct ... EO = DBSTAT ("oblk") 
block/indirect ... EO = DMS ( "DBSTAT, oblk") 
record/direct ... EO = DBSTAT (oblk) 
record/indirect... EO = DMSD ( "DBSTAT" , oblk) 
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GMC 


Command and Arguments 
GMC, set-1, oblk 


Currency Indicators 

DSfid: CO (set-1) Ch an ged: none 

Description 

The number of member records connected to the current owner of 
set-1 is returned in the host language variable defined for oblk. 
This variable must be consistent with a four byte, unsigned data 
item (see system specific manuals). If a user does not have read 
access to set-1, the member count is not returned and a command 
status error is issued. 


Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


GMC (" set-1, oblk") 

DMS ("GMC, set-1, oblk") 
GMC ( n set-l " , oblk) 

DMSD ("GMC, set-1", oblk) 


GQC 


Get Qwner Count 


GQC 


Command and Arguments 
GOC, set-1 , oblk 
Currency Indicators 

IlSfid: CM (set-1) Chansfid: none 

Description 

The number of owner records connected to the current member of 
set-1 is returned in the host language variable defined for oblk. 
This variable must be consistent with a four byte, unsigned data 
item (see system specific manuals). If a user does not have read 
access to set-1, the owner count is not returned and a command 
status error is issued. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= GOC ("set-1, oblk") 

= DMS ("GOC, set-1, oblk") 

= GOC ("set-1", oblk) 

= DMSD ("GOC, set-1”, oblk) 
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GIC fiet Type of current of run unit otc 


Command and Arguments 
GTC, oblk 

Currency Indicators 

Used: cru fihansad *. none 

Description 

The name of the record type for the record that is current of run 
unit is returned in oblk's host language variable. That variable 
must be consistent with an eight byte, character data item. 

Examples of Command Usage 


block/direct ... 

EO = 

GTC 

("oblk") 

block/indirect ... 

EO = 

DMS 

( "GTC, oblk") 

record/direct ... 

EO = 

GTC 

(oblk) 

record/indirect. . . 

EO = 

DMSD 

( "GTC", oblk) 


fiet 

Type 

of Member 


Command and Arguments 
GTM, set-1, oblk 
Currency Indicators 

Used: CM (set-1) ChanSfid: none 

Description 

The name of the record type for the record that is the current 
member of set-1 is returned in oblk's host language variable. 
That variable must be consistent with an eight byte, character 
data item. If a user does not have read access to set-1, a 
command status error is returned and the value of oblk's host 
language variable is unchanged. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= GTM ("set-1, oblk") 

= DMS ("GTM, set-1, oblk") 

= GTM ("set-1", oblk) 

= DMSD ("GTM, set-1", oblk) 
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GTO Get Type of £wner GTO 


Command and Arguments 
GTO, set-1, oblk 
Currency Indicators 

Used : CO (set-1) Chanced : none 

Description 

The name of the record type for the record that is the current 
owner of set-1 is returned in oblk's host language variable. 
That variable must be consistent with an eight byte, character 
data item. If a user does not have read access to set-1, a 
command status error is returned and the value of oblk's host 
language variable is unchanged. 

Examples of Command Usage 

block/direct ... EO = GTO ("set-1, oblk") 
block/ indirect ... EO = DMS ( "GTO, set-1 , oblk" ) 
record/direct ... EO = GTO ("set-1", oblk) 
record/ indirect. . . EO » DMSD ("GTO, set-l"oblk) 


NCI Hull all Gurrency Indicators NCI 


Command and Arguments 

NCI (no arguments) 

Currency Indicators 

Used : none Changed : all currency indicators null 

Description 

All currency indicators are made null, with the exceptions of 
current owners of system-owned sets. The active lock statuses 
are not affected. Thus, if MCP is in effect, NCI nulls the 
current of run unit; but as soon as the current of run unit again 
becomes non-null, its record is actively locked. 

Examples of Command Usage 


block/direct ... 

EO 

= NCI 

( 

) 

block/indirect ... 

EO 

= DMS 

("NCI" 

) 

record/direct ... 

EO 

= NCI 

( 

) 

record/ indirect. . . 

EO 

= DMS 

("NCI" 

) 
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I£H Test Current of run unit for Null tcn 


Command and Arguments 

TCN (no arguments) 

Currency Indicators 

Used : CRU Chang ed: none 

Description 

A command status of 255 is returned if the current of run unit is 
null. If it is not null, the command status is 0. 

Examples of Command Usage 

block/direct ... E0 = TCN ( ) 

block/indirect ... E0 = DMS ("TCN") 

record/direct ... E0 = TCN ( ) 

record/indirect ... E0 = DMS ("TCN") 


TCT Test Current of run unit Type tct 


Command and Arguments 
TCT,rec 

Currency Indicators 

Used : CRU Changed : none 

Description 

The record type of the current of run unit is compared to rec. 
If they are the same, the command status is 0. If they are not 
the same, the command status is 3. 

Examples of Command Usage 

block/direct ... E0 = TCT ("rec") 
block/indirect ... E0 = DMS ("TCT, rec") 
record/direct ... E0 = TCT ("rec") 
record/ indirect .. . E0 = DMS ("TCT, rec") 
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TMN Test Member for Null TMH 


Command and Arguments 
TMN, set-1 

Currency Indicators 

Used: CM (set-1) Changed: none 

Description 

If the current member of set-1 is null, a command status of 255 
is returned. If it is not null, the command status is 0. 

Examples of Command Usage 

block/direct ... E0 = TMN Cset-l") 

block/indirect ... E0 = DMS ( "TMN, set-1") 

record/direct ... E0 = TMN ("set-1") 

record/indirect ... E0 = DMS ( "TMN, set-1 " ) 


TMT Test Member Type IMT 


Command and Arguments 
TMT,rec, set-1 
Currency Indicators 

Used: CM (set-1) Changed: none 

Description 

The record type of the current member of set-1 is compared to 
rec. If they are the same, the command status is 0. If they are 
not the same, the command status is 3. 

Examples of Command Usage 

block/direct ... E0 = TMT ( "rec , set-1 " ) 
block/indirect ... E0 = DMS ( "TMT, rec , set-1 " ) 
record/direct ... E0 = TMT ( "rec , set-1 " ) 
record/indirect... E0 = DMS ( "TMT, rec, set-1 " ) 
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IQH lest Qwner for Hull TON 

Command and Arguments 
TON, set-1 

Currency Indicators 

Used: CM (set-1) Changed: none 

Description 

If the current owner of set-1 is null, a command status of 255 is 
returned. If it is not null, the command status is 0. 

Examples of Command Usage 

block/direct ... E0 = TON ("set-1") 

block/indirect ... E0 = DMS ( "TON, set-1 " ) 

record/direct ... E0 = TON ("set-1") 

record/indirect ... E0 = DMS ( "TON, set-1 ") 


TQT lest Qwner Type TQT 


Command and Arguments 
TOT, rec, set-1 
Currency Indicators 

Used: CO (set-1) Changed: none 

Description 

The record type of the current owner of set-1 is compared to rec. 
If they are the same, the command status is 0. If they are not 
the same, the command status is 3. 

Examples of Command Usage 

block/direct ... E0 = TOT ( "rec, set-1") 
block/indirect ... E0 = DMS ( "TOT, rec, set-1") 
record/direct ... E0 = TOT ( "rec , set-1 " ) 
record/indirect... E0 = DMS ( "TOT, rec, set-1") 
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TUN 


lest User indicator for Null 


TUN 


Command and Arguments 
TUN, iblk 


Currency Indicators 

Used: CU(i) Changed: none 

Description 

The value of iblk's host language variable determines the user 
indicator which is tested for being null. That variable must be 
consistent with a one byte, unsigned data item. A 255 command 
status is returned if the indicated user indicator is null. If 
it is not null, then a 0 command status is returned. 


Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


TUN ("iblk") 

DMS ("TUN, iblk") 
TUN (iblk) 

DMS ("TUN", iblk) 
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XII. BOOLEAN COMMANDS 


A. Overview 

MDBS DML supports the Boolean int£XS££t (i.e., logical AND) and 
dl££££££t££ operators on sets. Each Boolean DML command has three sets 
as arguments. The first two sets are used to specify inputs to the 
Boolean operation. The third set is a system-owned set whose member 
record occurrences, after the execution of a Boolean command, are the 
result of the Boolean operation. This system-owned set must be either 
9SYSSET or a set that owns all record types whose occurrences could be 
a result of the Boolean operation. The first two set names may or may 
not be the same ($SYSSET can be used as an input set). The third set 
can be the same as either of the first two sets. The user of a 
Boolean command must have read access to the first two sets and write 
access to the third set. 

Each Boolean command utilizes the first two user-defined 
indicators. These must have been allocated prior to invoking the 
Boolean command. They are automatically allocated by the DBOPN 
command and can be reallocated by the AUI command, as needed. 

There are four intersect commands. Take the intersection of 

1. the members of the owner of the first set (as indicated by 
the first user indicator) and the members of the owner of 
the second set (as indicated by the second user indicator): 
AMM: , 

2. the members of the owner of the first set (as indicated by 
the first user indicator) and the owners of the member of 
the second set (as indicated by the second user indicator) : 
AMO, 

3. the owners of the member of the first set (as indicated by 
the first user indicator) and the members of the owner of 
the second set (as indicated by the second user indicator): 
AOM, 

4. the owners of the member of the first set (as indicated by 
the first user indicator) and the owners of the member of 
the second set (as indicated by the second user indicator): 
AOO . 

Similarly, there are four difference commands. Exclude from 

1. the members of the owner of the first set (as indicated by 

the first user indicator) those records that are also 
members of the owner of the second set (as indicated by the 
second user indicator): XMM, 

2. the members of the owner of the first set (as indicated by 

the first user indicator) those records that are also owners 
of the member of the second set (as indicated by the second 
user indicator): XMO, 
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3. the owners of the member of the first set (as indicated by 

the first user indicator) those records that are also 
members of the owner of the second set (as indicated by the 
second user indicator): XOM, 

4. the owners of the member of the first set (as indicated by 

the first user indicator) those records that are also owners 
of the member of the second set (as indicated by the second 
user indicator): X00. 

In the case of multiple areas, all areas allowing pointer arrays must 
be on-line during the execution of Boolean commands. 


B. Command Details 

AHM And of Members with Members AMM 


Command and Arguments 

AMM, set-1, set-2, set-3 


Currency Indicators 


Used: cud) Changed: cm (set-3) < null 

CU ( 2) CRU < null 

Description 

Take the intersection (logical AND) of the members of the owner 
of set-1 (denoted by the first user indicator) and the members of 
the owner of set-2 (denoted by the second user indicator). All 
records in the intersection are made members of set-3. Any 
member of set-3 that is not in the intersection is disconnected 
from set-3 during the execution of AMM. The current member of 
set- 3 and the current of run unit become null and the command 
status becomes 255. If the member order of set-3 is not sorted, 
then the ordering of members of set-3 after AMM is a function of 
the member order of set-1 and the member order of set-2. $SYSSET 
has FIFO ordering. 


It is not reasonable to use AMM unless the member record types of 
set-1 and the member record types of set-2 have at least one 
record type in common. Otherwise, the intersection will be 
empty, if set=2 is nai ISISSETj. than if must awn sash resard 
type that is hath a member af setzl and a member af set=2. if 
the intersection is empty, then set-3 will have no members. 

Examples and Command Usage 


block/direct 
block/indirect . . 
record/direct 
record/indirect. . 


EO 

= AMM 

( "set 

EO 

= DMS 

("AMM 

EO 

= AMM 

( "set 

EO 

= DMS 

( "AMM 


1 , set-2 , set-3 " ) 
set-1 , set-2 , set- 3 " ) 
1 , set-2, set-3") 
set-1 , set-2 , set-3 " ) 
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AMD 


And of Members with Owners 


AMD 


Command and Arguments 

AMO, set-1 , set-2 , set-3 
Currency Indicators 

Used: cud) Obansed: CM (set-3) < null 

cut 2) CRU < null 

Description 

Take the intersection (logical AND) of the members of the owner 
of set-1 (denoted by the first user indicator) and the owners of 
the member of set-2 (denoted by the second user indicator). All 
records in the intersection are made members of set-3. Any 
member of set-3 that is not in the intersection is disconnected 
from set-3 during the execution of AMO. The current member of 
set-3 and the current of run unit become null and the command 
status becomes 255. If the member order of set-3 is not sorted, 
then the ordering of members of set-3 after AMO is a function of 
the member order of set-1 and the owner order and of set-2. 
5SYSSET has FIFO ordering. 

It is not reasonable to use AMO unless the member record types of 
set-1 and the owner record types of set-2 have at least one 
record type in common. Otherwise, the intersection will be 
empty, if sefnl is net ISXSSET.*. than if must own sash record 
type that is both a member: of set-1 and an owner of sef=:2. if 
the intersection is empty, then- set-3 will have no members. 

Examples and Command Usage 

block/direct ... EO = AMO ( "set-1 , set-2 , set-3 " ) 
block/indirect ... EO = DMS ( "AMO, set-1 , set-2 , set-3") 
record/direct ... EO = AMO ( "set-1 , set-2 , set-3 " ) 
record/indirect... EO = DMS ( "AMO, set-1 , set-2, set-3") 


AQM 


And of Owners with Members 


AQM 


Command and Arguments 

AOM, set-1 , set-2 , set-3 
Currency Indicators 

Used: cu(l) Changed: CM (set-3 ) < null 

CU ( 2) CRU < null 
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Description 

Take the intersection (logical AND) of the owners of the member 
of set-1 (denoted by the first user indicator) and the members of 
the owner of set-2 (denoted by the second user indicator). All 
records in the intersection are made members of set-3. Any 
member of set-3 that is not in the intersection is disconnected 
from set-3 during the execution of AOM. The current member of 
set-3 and the current of run unit become null and the command 
status becomes 255. If the member order of set-3 is not sorted, 
then the ordering of members of set-3 after AOM is a function of 
the owner order of set-1 and the member order of set-2. 5SYSSET 
has FIFO ordering. 


It is not reasonable to use AOM unless the owner record types of 
set-1 and the member record types of set-2 have at least one 
record type in common. Otherwise, the intersection will be 
empty, if sfitrl is naf iSYSSEIx then if must awn each record 
type that is hath an aunar af set=l and a member af sef=2. if 
the intersection is empty, then set-3 will have no members. 


Examples and Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= AOM ("set-1, set-2, set-3”) 

= DMS ( "AOM, set-1 , set-2 , set-3 " ) 
= AOM ( "set-1 , set-2 , set-3 " ) 

= DMS ("AOM, set-1, set-2, set-3") 


AOp And of Owners with Owners AQO 

Command and Arguments 

AOO , set-1 , set-2 , set-3 
Currency Indicators 

Used; cud) Chansed: CM (set-3) < null 

CU ( 2) CRU < null 


Description 

Take the intersection (logical AND) of the owners of the member 
of set-1 (denoted by the first user indicator) and the owners of 
the member of set-2 (denoted by the second user indicator). All 
records in the intersection are made members of set-3. Any 
member of set-3 that is not in the intersection is disconnected 
from set-3 during the execution of AOO. The current member of 
set-3 and the current of run unit become null and the command 
status becomes 255. If the member order of set-3 is not sorted, 
then the ordering of members of set-3 after AOO is a function of 
the owner order of set-1 and the owner order of set-2. $SYSSET 
has FIFO ordering. 
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It is not reasonable to use A00 unless the owner record types of 
set-1 and the owner record types of set-2 have at least one 
record type in common. Otherwise, the intersection will be 
empty, if is net ISXSSElx then it must sun each retard 
type that is bath an awner af satnl and an assner af set=2. if 
the intersection is empty, then set-3 will have no members. 


Examples and Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= A00 ("set-1, set-2, set-3") 

= DMS ("AOO, set-1, set-2, set-3") 
= AOO ("set-1, set-2, set-3") 

= DMS ("AOO, set-1, set-2, set-3") 




exclude Members from Members 


XMM 


Command and Arguments 

XMM, set-1 , set-2 , set-3 
Currency Indicators 

Used r cud) Changed: cm (set-3) < null 

CU ( 2) CRU < null 


Description 

Exclude (logical difference) from the members of the owner of 
set-1 (denoted by the first user indicator) those records that 
are also members of the owner of set-2 (denoted by the second 
indicator). All records in the difference are made members of 
set-3. Any member of set-3 that is not in the logical difference 
is disconnected from set-3 during the execution of XMM. The 
current member of set-3 and the current of run unit become null 
and the command status becomes 255. If the member order of set-3 
is not sorted, then the ordering of members of set-3 after XMM is 
a function of the member order of set-1 and the member order of 
set-2. $S YSSET has FIFO ordering. 


It is not reasonable to use XMM unless the member record types of 
set-1 and the member record types of set-2 have at least one 
record type in common. If setrl is net iSXSSETx than it must QWD 
each retard type that is bath a member af set-1 and a member af 
set=2. If the difference is empty, then set-3 will have no 
members. 


Examples and Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= XMM ("set-1, set-2, set-3") 

= DMS ("XMM, set-1, set-2, set-3") 
= XMM ("set-1, set-2, set-3") 

= DMS ("XMM, set-1, set-2, set-3") 
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XMQ exclude Members from Qwners XMQ 


Command and Arguments 

XMO, set-1 , set-2 , set-3 
Currency Indicators 

IlSfid: CU(1) Cbansfid: CM (set-3) <r- null 

CU ( 2) CRU < null 

Description 

Exclude (logical difference) from the members of the owner of 
set-1 (denoted by the first user indicator) those records that 
are also owners of the member of set-2 (denoted by the second 
indicator). All records in the difference are made members of 
set-3. Any member of set-3 that is not in the logical difference 
is disconnected from set-3 during the execution of XMO. The 
current member of set-3 and the current of run unit become null 
and the command status becomes 255. If the member order of set-3 
is not sorted, then the ordering of members of set-3 after XMO is 
a function of the member order of set-1 and the owner order of 
set-2. $S YSSET has FIFO ordering. 

It is not reasonable to use XMO unless the member record types of 
set-1 and the owner record types of set-2 have at least one 
record type in common. If Sfifzl is net ISXSSElx then it must ewn 
each racerd type that is bath a member of satrl and an QHner of 
aet=2- If the difference is empty, then set-3 will have no 
members. 

Examples and Command Usage 

block/direct ... EO - XMO ( "set-1 , set-2 , set-3 " ) 
block/indirect ... EO = DMS ( "XMO, set-1 , set-2 , set-3 " ) 
record/direct ... EO = XMO ("set-1, set-2, set-3") 
record/indirect... EO = DMS ( "XMO , set-1 , set-2 , set-3 ") 
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XOM exclude Owners from Members XQH 


Command and Arguments 

XOM, set-1 , set-2 , set-3 
Currency Indicators 

Used: CU(l) Chansad: CM(set-3)< null 

CU ( 2) CRU null 

Description 

Exclude (logical difference) from the owners of the member of 
set-1 (denoted by the first user indicator) those records that 
are also members of the owner of set-2 (denoted by the second 
indicator). All records in the difference are made members of 
set-3. Any member of set-3 that is not in the logical difference 
is disconnected from set-3 during the execution of XOM. The 
current member of set-3 and the current of run unit become null 
and the command status becomes 255. If the member order of set-3 
is not sorted, then the ordering of members of set-3 after XOM is 
a function of the owner order of set-1 and the member order of 
set-2. $S YSSET has FIFO ordering. 

It is not reasonable to use XOM unless the owner record types of 
set-1 and the member record types of set-2 have at least one 
record type in common. If fifitrl is not SSISSETx then it must swn 
aash raccrd type that is heth an csznar of setrl and a member of 
set-2- If the difference is empty, then set-3 will have no 
members. 

Examples and Command Usage 

block/direct ... EO = XOM ( "set-1 , set-2 , set-3 " ) 
block/indirect ... EO = DMS ( "XOM, set-1 , set-2 , set-3 " ) 
record/direct ... EO = XOM ( "set-1 , set-2 , set-3 ") 
record/indirect... EO = DMS ( "XOM, set-1 , set-2 , set-3 ") 
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XQQ exclude Owners from Owners XQQ 


Command and Arguments 

XOO, set-1 , set-2, set-3 
Currency Indicators 

Used: cud) Changed: cm (set-3) 4- — -null 

CU ( 2) CRU < null 

Description 

Exclude (logical difference) from the owners of the member of 
set-1 (denoted by the first user indicator) those records that 
are also owners of the member of set-2 (denoted by the second 
indicator). All records in the difference are made members of 
set-3. Any member of set-3 that is not in the logical difference 
is disconnected from set-3 during the execution of XOO. The 
current member of set-3 and the current of run unit become null 
and the command status becomes 255. If the member order of set-3 
is not sorted, then the ordering of members of set-3 after XOO is 
a function of the owner order of set-1 and the owner order of 
set-2. $S YSSET has FIFO ordering. 

It is^ not reasonable to use XOO unless the owner record types of 
set-1 and the owner record types of set-2 have at least one 
record type in common. If SfiJtrl ifi nflt ISISSETj. then it must QMD 
east nasand type that is bath an own ex of set-1 and an awn ex of 
Set-2. If the difference is empty, then set-3 will have no 
members. 

Examples and Command Usage 

block/direct ... EO = XOO ( "set-1 , set-2 , set-3 " ) 
block/indirect ... EO = DMS ( "XOO, set-1 , set-2 , set-3 " ) 
record/direct ... EO = XOO ( "set-1 , set-2 , set-3 " ) 
record/indirect... EO = DMS ( "XOO, set-1 , set-2 , set-3 " ) 
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A. Overview 

There are several MDBS DML commands that are used only within 
certain host languages or environments. These are referred to as 
special commands. For instance, there are some commands that are used 
only in block-oriented host languages in order to define, extend, and 
undefine data blocks. Another special command is employed in 
languages that do not allow DML commands to be used as functions that 
take on a command status value. This command is used to set up the 
host language variable that will hold the command status. Yet another 
special command is used to alter the end-of-set command status number 
(255) . For instance, with FORTRAN, 255 can be altered to -1; this is 
useful in branching structures involving an arithmetic IF statement. 

A very important special command, used with nearly every host 
language, is SETPBF. It is used at the start of a program to set up 
the program buffers that MDBS. DMS will utilize for that run unit. In 
a single user environment, the program buffers are used as the page 
buffer region. It is advisable to allocate as much space as possible 
for page buffers. In a multiuser environment, the page buffer region 
is shared by many users and is therefore not allocated by an 
individual run unit. Each run unit may however, have its own program 
buffers that are used by MDBS. DMS when interacting with the run unit. 
A run unit uses SETPBF to allocate its program buffers. In some 
multiuser environments there is yet another special DML command that 
allows each run unit to control its own throughput priority level. 

The system specific manual for a host language and environment 
indicates which of these special commands are available in that 
setting. 


B. Command Details 

ALTEQS ALler £nd flf £et ALTEQS 


Command and Arguments 

ALTEOS (no arguments) 

Currency Indicators 

Used : none Changed : none 

Description 

The command status value of 255 that is normally used to indicate 
an end-of-set is altered within the scope of the application 
program that uses ALTEOS. If ALTEOS is permitted within a given 
host language, the system specific manual for that language 
indicates the altered end-of-set command status value (usually 
- 1 ) . 
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Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/ indirect. . . EO 


ALTEOS ( ) 
DMS ("ALTEOS") 
ALTEOS ( ) 
DMS ("ALTEOS") 


DBINIT Data £ase control system INIT ialization DBINIT 

Command and Arguments 

DBINIT, host language variables 
Currency Indicators 

Used ; none . Changed : none 

Description 

When DBINIT is available, it is invoked as the first DML command 
of a run unit. Two (or more) host language variables or 
constants are used as arguments. The nature of these arguments 
and the precise actions performed by DBINIT are operating system 
specific. See the appropriate system specific manual. In 

general, DBINIT initializes the data base control system (s) to be 
used by a run unit. 

In run units that support DBINIT, a single run unit can use 
DBINIT to have multiple MDBS data bases open simultaneously. 

Examples of Command Usage 

See system specific manuals. 


DBSEL Data fiase SEL ection DBSEL 

Command and Arguments 

DBSEL, host language variable 
Currency Indicators 

Used ; none Changed ; none 

Description 

Where DBSEL is available, it can be used by a run unit to select 
any one of the concurrently open MDBS data bases for processing. 
The host language variable (or constant) is used to indicate 
which of the data bases is to be processed. 

Examples of Command Usage 

See system specific manuals. 
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DEFINE 

DEFINE data block 

DEFINE 

Command and Arguments 

DEFINE, blk, list 
Currency Indicators 



Used: none 

Description 

Changed: none 



This command is used with host languages that do not support 
program record types. It defines the bile data block to have the 
characteristics indicated in list. The composition of list is 
host language dependent. It typically consists of at least a 
list of the host language variables that make up the data block. 
Full details for each host language appear in the system specific 
manuals. 

A data block must have been defined with the DEFINE command 
before it can be used as an argument in any other DML command. A 
given host language variable can appear more than once in the 
same or different data blocks. Many different data blocks can be 
used in a host language program. Only the last data block 
defined before using DBOPN will exist after invoking DBOPN. Any 
data block defined after the data base is opened will continue to 
exist until it is undefined (with the UNDEF command) . 

Examples of Command Usage 

block/direct ... EO = DEFINE ("blk" , list) 
block/indirect ... EO = DMSD ( "DEFINE, blk" , list) 
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DMSSJP 


DMS get slum£ 


DMSSJP 


Command and Arguments 

DMSSJP, host language jump description, command status array 
Currency Indicators 

Used : none Changed ; none 

Description 

This special command pertains to C host languages and provides a 
concise error trapping mechanism. The indicated host language 
jump description is a pointer to a stack environment. The values 
of the indicated array specify which command status numbers are 
to be exempted from the error trapping. The last element of this 
array must have a value of 0. 

When DMSSJP is invoked, its first argument indicates the 
environment to which control is transferred whenever a command 
status other than those specified in the array occurs. This 
condition remains in force until DMSSJP is re-invoked with a 
different argument (indicating a different error handling module 
or a different set of exempt command status numbers) . If the 
first argument is 0, then standard error handling is resumed. If 
the second argument is 0 rather than an array, then all command 
status numbers other than 0 and 255 are trapped. 

Example of Command Usage 

See system specific manuals. 


EXTEND EXTEND data block EXTEND 

Command and Arguments 
EXTEND, b lk, list 
Currency Indicators 

Used : none Changed : none 

Description 

This command is used with host languages that do not support 
program record types. It is used to extend the previously 
defined blk data block by assigning more host language variables 
to it. These additional variables are indicated in list and they 
will follow the variables already defined for the data block. 
The composition of list is host language dependent. It typically 
consists of at least a list of the additional variables. Full 
details for each host language appear in the system specific 
manuals . 
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The bile data block must have been defined with the DEFINE command 
before it can be used in an EXTEND command (otherwise a command 
status of 7 is returned). A given host language variable can 
appear more than once in the same or different data blocks. 

Examples of Command Usage 

block/direct ... EO = EXTEND ("blk", list) 
block/indirect ... EO = DMSD (" EXTEND, blk" , list) 


MPL Multiuser Eriority Level MPL 

Command and Arguments 
MPL, iblk 


Currency Indicators 

Used ; none Chang ed: none 


Description 

The MPL command is of interest in multiuser processing 
situations. It enables different run units to have varying 
degrees of throughput priority. If a run unit invokes MPL, the 
value of iblk's host language variable is used to set that run 
unit's priority. The iblk host language variable must be 
consistent with a two byte unsigned data item. Its value can be 
any integer from 1 through 10. 

The highest possible priority level is 1. Selecting this level 
results in throughput that is at least as fast as level 2. Level 
2 throughput, in turn, is at least as fast as level 3, and so 
forth. A run unit that does not require fastest throughput 
should use MPL to set its priority level lower than 1 (i.e., 
2-10). A run unit that requires more than minimal throughput 
should use MPL to set its priority level higher than 10 (i.e., 
9-1). A run unit can invoke MPL repeatedly to alter its own 
priority level at desired points in the program. 


An interactive run unit has a priority level of 3 until it 
invokes MPL to get a different priority. A batch run unit has a 
priority level of 7 until it invokes MPL to get a different 
priority. 


Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


MPL ("iblk") 

DMS ("MPL, iblk”) 
MPL (iblk) 

DMSD ("MPL” , iblk) 
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S EXE BE. SET Erogram EuEfer region SETPBF 


Command and Arguments 
SETPBF, list 

Currency Indicators 

Used: none Changed : none 

Description 

This command allocates the region of main memory that is to be 
used for program buffers. If SETPBF is invoked, it must appear 
before any other DML command that needs to use program buffers. 
The composition of list is environment dependent and is fully 
discussed in the various system specific manuals. It typically 
consists of a starting address and a length (in bytes) for the 
page buffer area. For instance, with FORTRAN the starting 
address could be indicated by an array name and the length would 
be the number of bytes occupied by that array. In the C 
language, for example, the SBRK function is a dynamic memory 
allocation function; the value returned by SBRK can be used as an 
input to the SETPBF DML command . 

In many environments the programmer can optionally omit SETPBF. 
If omitted in a single-user environment, MDBS. DMS itself sets up 
the largest program (i.e., page) buffer region possible. If 
omitted in a multiuser environment, MDBS. DMS allocates adequate 
program buffers. For a given operating environment, the system 
specific manual indicates whether SETPBF can be omitted. 

Examples of Command Usage 

See system specific manuals. 


UNDEF 


UNDEF ine data blocks 


HUELEZ 


Command and Arguments 

UNDEF (no arguments) 

Currency Indicators 

Used : none Changed : none 


Description 

All data blocks previously defined in the program are undefined 
(i.e., they no longer exist). This is typically employed in host 
language programs that use chaining. UNDEF is invoked before the 
call to a chained subprogram and needed data blocks are redefined 
within the subprogram. 
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Examples of Command Usage 

block/direct ... EO = UNDEF ( ) 

block/indirect ... EO = DMS ("UNDEF") 

varcmd VABiable for CotJmanB string 2&R£198 


Command and Arguments 

VARCMD, host language variable 
Description 

This special command is used in some host languages to specify a 
host language variable, whose value is treated as a DML command 
string. The application program sets the value of this variable 
to the desired command string (i.e., DML command and arguments) 
prior to each invocation of the data base control system. 

Examples of Command Usage 

See system specific manuals. 


VARCS VABiable for Command Status VABCS 

Command and Arguments 

VARCS, host language variable 
Currency Indicators 

UfiSd: none Chansfid: none 

Description 

The indicated host language variable will hold the command status 
that results from invoking a DML command. VARCS is needed only 
in those very few host languages that do not permit function 
subprograms. If VARCS is available for a host language (see 
system specific manuals), it should be the first DML command used 
in an application program. An exception to this is the case 
where DBINIT is also available, in which case VARCS is invoked 
after DBINIT. 

Examples of Command Usage 

See system specific manuals. 
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A. Overview 

In a multiuser environment, MDBS III supports two kinds of record 
locking: passive and active. A record is passively locked if it is 

the current of any run unit, the current owner or current member of 
any set for any run unit, the current record occurrence of any record 
type for any run unit (for 3a only: see Appendix A) , or the current 

record for any user-defined indicator in any run unit. A record can 
be actively locked by invoking a DML multiuser locking command (of 
which there are several) . As long as a record is locked by one run 
unit, other run units are denied either read, write, or read and write 
access to that record. The type of access denied depends on whether 
the record is actively or passively locked. 

Restrictions to access caused by multiuser locking do not affect 
security restrictions on a user's access. All security restrictions 
are enforced independently of whether an environment is single user or 
multiuser (though page image posting is unavailable for multiuser) . 
Using a multiuser locking command in a single user environment has no 
effect. 

In a multiuser environment, a record can be read if it is not 
locked or if it is passively locked. A record cannot be read if it is 
actively locked. A run unit can modify a record, if that record is 
not locked by any other run unit. As long as a record is actively or 
passively locked by one run unit, no other run unit can modify it. 

The programmer of application systems for a multiuser environment 

should keep the following facts in mind: 

1. If a record is not actively locked and a run unit has that 
record passively locked (i.e., it is a current record for 
that run unit), any run unit can read it.* 

2. If a run unit has a record actively locked, no other run 

unit can read that record until the active lock is removed 
(with a DML command described in this chapter) «, 

3. If a record is not actively locked and more than one run 

unit has that record passively locked, then no run unit can 
change or delete the record until all other run units have 
removed their passive locks on that record (e.g., with a DML 
assignment or find command) . 

4. If a run unit has a record actively locked, no other run 

unit can possibly change that record until the active lock 
is removed. 

There are four types of active locking commands, which differ 
according to the scope of records that they actively lock. One 
actively locks the current of run unit, which is normally only 

* ’ 

MDBS QRS utilizes passive locking. 
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Table XIV-1: Multiuser Locking Contention Protocols 


\ Run Unit B 
N. attempts 

Run Unit a\ 
has \ 

Find or 
retrieve 
locked 
record 

Modify 

locked 

record 

Create 

record 

Connect 

record 

into 

set-2 

Disconnect 
a record 
from 
set-2 

Disconnect 
all member 
(owner) 
records 
from set-2 

Delete 

record 


permitted 

not permitted^ 

not relevant 

permitted 

not permitted 
if A has the 
same CO and CM 
for set-2 as B 

not permitted 
if A has the 
same CO (CM) for 
set-2 as B and 
CM(CO) of set-2 
for A is non- 
null 

not permitted 

Active lock 
on a record 

not permitted 

not relevant 

not relevant 

not relevant 

not relevant 

permitted 

not relevant 

Active lock on 
all records of 
a record type 



not permitted 

not relevant 

not relevant 

permitted 

not permitted 

Active lock on 
all records of 
set-l 

not permitted 
through set-1 

not permitted 
if attempt to 
modify sort 
key value of 
set-1 

not permitted 
if record is 
auto owner or 
member of 
set-1 

not permitted 
if set-1 - 
set-2 

not permitted 
if set-l - 
3et-2 

not permitted 
if set-l - 
set-2 

not permitted 
if record is 
owner or mem- 
ber of set-l 


* Modification is permitted if B's run unit environment has been 
altered by invoking DBENV with a host language variable value of 4. 
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passively locked. Another command allows a run unit to declare that 
one or more user-defined indicators are to be actively (rather than 
passively) locked. Another kind of active locking command places an 
active lock on all occurrences of a record type. The fourth actively 
locks a set, meaning that no other run unit can utilize that set and 
that the occurrences of that set's owner and member record types are 
actively locked. The effects of these locks on record retrieval, 
modification, creation, connection, disconnection and deletion are 
presented in Table XIV-1. A special DML command for setting run unit 
priority levels is available in some environments (see Chapter XIII) . 

If one run unit attempts to access a record occurrence (or set) 
that is locked in such a way that access is prohibited, then the 
access attempt will be re-tried periodically until either access is 
accomplished or some number of failed access tries have occurred. In 
the latter case, a command status message, indicating that a needed 
record is locked, is returned to the program. At any juncture in a 
program, the programmer can use a DML command (MCC) to specify the 
number of retries and the time units between tries. Defaults for 
these are operating system dependent (see MDBS System Specific 
Manuals) . 

As soon as a run unit invokes DBCLS, all records that it had 
locked are freed. 


B. Command Details 


MAU .Multiuser Active User indicators MAU 

Command and Arguments 
MAU , ibl k 

Currency Indicators 

Used ; user indicators Chang ed: none 

Description 

One host language variable is defined for iblk. It must be 
consistent with a one byte unsigned data item. The value of that 
variable must be an integer between 0 and 255 inclusive. This 
value indicates how many user-defined indicators are to be made 
actively locked, rather than passively locked. If the value is 
0, then all user-defined indicators revert to their normal state 
of being passively locked. If the value is 12, then user 
indicators 1 through 12 are actively locked and all other 
allocated user indicators are passively locked. MAU can be used 
repeatedly within a run unit to alter the number of user 
indicators that are actively locked. 

A user indicator must have been allocated (with AUI) before it 
can be declared to be actively locked. A command status message 
of 62 or 63 results from MAU if any record that is the current 
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record of a user indicator is already actively or passively 
locked by another run unit. In this case, MAU will not affect 
the current active/passive status of user indicators. 

Examples of Command Usage 

block/direct ... EO = MAU ("iblk") 

block/indirect ... EO = ("MAU, iblk") 

record/direct ... EO = MAU (iblk) 

record/indirect... EO = ("MAU", iblk) 


MCC. Hultiuser Contention Count MCC 


Command and Arguments 
MCC, iblk 

Currency Indicators 

Used : none Chang ed: none 

Description 

This command sets the number of re-tries and the time units 
between tries that will be enforced by MDBS. DMS when an access 
attempt is prohibited due to multiuser locking. This is enforced 
for all DML commands that follow MCC, until another MCC is 
invoked. The first host language variable for iblk has an 

integer value that indicates the number of re-tries. The second 
variable defined for iblk has an integer value that indicates the 
number of time units between tries. The time unit is operating 
system dependent (see system specific manuals) , but is never 
smaller than .01 seconds. Both of iblk's variables must be 
consistent with an unsigned data item that is two bytes in size. 

Examples of Command Usage 

block/direct ... EO = MCC ("iblk") 
block/indirect ... EO = DMS ("MCC, iblk") 
record/direct ... EO = MCC (iblk) 
record/indirect... EO = DMSD ("MCC", iblk) 


mcf Hultiuser Current of run unit £ree MCF 

Command and Arguments 

MCF (no arguments) 

Currency Indicators 

Used : CRU Changed : none 
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Description 

If the record that is the current of run unit has been actively 
locked by MCP, invoking MCF will free that record so that it is 
only passively locked. 

Examples of Command Usage 

block/direct ... EO = MCF ( ) 

block/indirect ... EO = DMS ("MCF") 
record/direct ... EO = MCF ( ) 

record/indirect... EO = DMSD ("MCF") 


MCE. 


Multiuser Current of run unit Erotect 


MCE 


Command and Arguments 

MCP (no arguments) 

Currency Indicators 

Used : CRU Changed : none 

Description 

When this command is executed, the record that is the current of 
run unit is actively locked for as long as it is the current of 
run unit. After MCP has been invoked (and before invoking MCF) , 
a record can become the current of run unit only if it is not 
actively or passively locked by some other run unit. When it 
does become the current of run unit, it becomes actively locked 
and the former current of run unit is no longer actively locked 
(by way of MCP) . 

To reinstate the current of run unit to its normal condition of 
being only passively locked, the MCF command is used. 

Examples of Command Usage 

block/direct ... EO = MCP ( ) 

block/indirect ... EO = DMS ("MCP") 
record/direct ... EO = MCP ( ) 

record/indirect... EO = DMSD ("MCP") 


(C) COPYRIGHT 1981 Micro Data Base Systems, Inc. 


Rev. 83A 97 



MOBS DMS MANUAL 


XIV. MULTIUSER COMMANDS 


MDBS DMS MANUAL 


MRTF Multiuser Record lype Rree mrtf 

Command and Arguments 

MRTF, rec (rec is optional) 

Currency Indicators 

Used : none Changed : none 


Description 

All record occurrences of rec are freed. They are no longer 
actively locked by the run unit. The exception is that if one of 
those occurrences is actively locked through some other multiuser 
protect command, then it is still actively locked (until the 
corresponding multiuser free command is invoked) . If no record 
type is specified with this command, then every record type that 
is actively locked by the run unit is freed. 

Examples of Command Usage 

block/direct ... EO = MRTF ("rec") 
block/indirect ... EO = DMS ("MRTF, rec") 
record/direct ... EO = MRTF ("rec") 
record/ indirect .. . EO = DMS ( "MRTF, rec" ) 


MRTP Multiuser Record ICype Rrotect MRTP 


Command and Arguments 
MRTP, rec 

Currency Indicators 

Used : none Changed : none 

Description 

All occurrences of the record type rec are actively locked by the 
run unit, if no other run unit has locked any of those 
occurrences (either actively or passively) . If any occurrence of 
rec is locked by another run unit, then the MRTP request is 
refused and a command status message to that effect is returned. 

Examples of Command Usage 

block/direct ... EO = MRTP ("rec") 
block/indirect ... EO = DMS ("MRTP, rec") 
record/direct ... EO = MRTP ("rec") 
record/indirect... EO = DMS ("MRTP, rec") 
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MSE 


Multiuser Set Eree 


MSE 


Command and Arguments 

MSF, set-1 (set-1 is optional) 

Currency Indicators 

Used. : none Changed ; none 

Description 

The indicated set-1 is freed if it has been actively locked 
earlier in the run unit. The record occurrences of the owner and 
member record types are no longer actively locked, unless there 
is also an active lock on one or more of those record types or on 
a record occurrence (until the corresponding multiuser free 
command is invoked) . If no set is specified, all of the run 
units' actively locked sets are freed. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


MSP (" set-1") 

DMS ("MSF, set-1") 
MSF ("set-1") 

DMS ("MSF, set-1") 


USE 


Multiuser &et protect 


BSE 


Command and Arguments 
MSP, set-1 
Currency Indicators 
Used : none 


Changed ; none 


Description 

An active lock is placed on set-1, if no other run unit has a 
lock (either active or passive) on both an owner record and a 
member record of that set. If any such occurrence is locked by 
another run unit, then the MSP request is refused and a command 
status message to that effect is returned. 


Examples of Command Usage 

block/direct ... EO = 
block/indirect ... EO = 
record/direct ... EO = 
record/indirect... EO = 


MSP ("set-1") 

DMS ("MSP, set-1") 
MSP ("set-1") 

DMS ("MSP, set-1") 
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XV. RECOVERY COMMANDS 

A. Overview 

The features and commands described in this chapter are available 
in various versions of the RTL form of the MDBS data base management 
system. The RTL form requires a larger minimum buffer size than the 
standard form. Invoking a recovery command follows the same 
conventions as invoking any other DML command. The recovery commands 
fall into two groups: 

1. those that deal with page image posting of complex 
transactions (TRABT, TRBGN, TRCOM, PIFD) , and 

2. those that deal with the logging of transactions 
(LGFILE , LG FLSH, LG MSG, TRBGN, TRCOM) . 

Page image posting may be considered to form a first line of 
defense against data base inconsistency due to external factors such 
as power failures. The transaction logging commands provide the 
ultimate defense against failures of many kinds, including power 
failures, hardware malfunctions, and erroneous (although authorized) 
data modification. Either or both of the two recovery approaches can 
be used by an application program. However, page image posting is not 
meaningful in multiuser situations. 

Page image posting allows the application developer to specify 
the beginning of a complex transaction sequence (with the TRBGN 
command). The data base changes caused by the transaction sequence 
are not incorporated into the data base until the commit command 
(TRCOM) is invoked. A transaction sequence can be aborted by invoking 
the abort (TRABT) command. An abnormal termination of the program in 
the midst of a complex transaction sequence will not leave the data 
base inconsistent. When the data base is re-opened, it is consistent. 
It is current up to the point of the last invocation of TRBGN before 
the interruption. 

A page image preservation file is used by MDBS . DM S to provide 
this automatic recovery capability. The page image file must be 
declared with the PIFD command prior to opening the data base. If 
PI FD is not invoked, no posting occurs. If a page image file of 
insufficient size is used, then the data base could become 
inconsistent if a transaction sequence is abnormally interrupted. In 
this event, a command status error to that effect is returned when an 
attempt is made to re-open the data base. The log of transactions can 
be used to recover from such a situation. 

Transaction logging allows an application program to make use of 
the log file defined in the DDL specification. The name of the file 
used for logging a program's transactions can be changed with the 
LGFILE command. All transactions since the last data base back-up are 
automatically logged onto the log file. The log file is used by the 
RCV utility (provided with the RTL form). RCV can be used to 
automatically re-apply transactions to an old back-up copy of the data 
base, thereby recreating an up-to-date data base. The user has 
extensive control over which transactions are re-applied. 
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The TRBGN command is used to indicate the start of a complex 
sequence of transactions, for the purpose of transaction logging. The 
TRCOM command terminates the complex transaction sequence started by 
TRBGN. RCV will ignore any logged transactions that occur after an 
TRBGN, if a subsequent TRCOM was not reached during a run unit. Other 
commands that can be used in conjunction with transaction logging are 
LGFLSH and LGMSG which flush the log file buffers and insert messages 
into the log file, respectively. 

A complete description of the RTL form is presented in the MDBS- 
RTL Manual. 


B. Command Details 


LGFILE LoG £IL£ specification LGFILE 


Command and Arguments 
LGFILE, iblk 
Currency Indicators 

Used: none Changed: none 

Description 

The fully qualified name of a file to which transactions can be 
logged is specified by iblk's host language variable. This 
variable must be consistent with a string data item, whose 
maximum length is operating system dependent (see the appropriate 
system specific manual for size information). If the file to 
which transactions are to be logged is the same as the log file 
specified in the DDL specification, this command need not be 
invoked. If it is invoked, this command must appear before the 
DBOPN command. 

Examples of Command Usage 

block/direct ... EO = LGFILE ("iblk") 
block/indirect ... EO = DMS ( "LGFILE, iblk") 
record/direct ... EO = LGFILE (iblk) 
record/indirect... EO = DMSD ( "LGFILE ", iblk) 
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LGFLSH LoG file buffer ELu£E LGFLSH 


Command and Arguments 

LGFLSH (no arguments) 


Currency Indicators 

Used : none Changed : none 

Description 

The buffers holding transactions to be logged are flushed to the 
log file when this command is invoked. LGFLSH is automatically 
invoked by DBSAVE . This is especially useful when an important 
transaction has been processed by the system. It can be written 
to the log file before the log file buffer is full. 

Examples of Command Usage 

block/direct ... EO = LGFLSH ( ) 

block/indirect ... EO = DMS ("LGFLSH") 

record/direct ... EO = LGFLSH ( ) 

record/indirect... EO = DMS ("LGFLSH") 


LGMSG Lofi file MeGsaGe LGMSG 


Command and Arguments 
LGMSG, iblk 
Currency Indicators 

Used : none Changed : none 

Description 

The message specified in iblk's host language variable is written 
to the log file. This variable must be consistent with a string 
data item not exceeding 90 bytes. Messages written to the log 
file can be listed using the RCV utility program. The use of the 
LGMSG command is especially useful for surveillance. 

Examples of Command Usage 

block/direct ... EO = LGMSG ("iblk") 
block/indirect ... EO = DMS ("LGMSG, iblk") 
record/direct ... EO = LGMSG (iblk) 
record/indirect... EO = DMSD ("LGMSG" , iblk) 
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eieu 


Eage Image Eile Declaration 


EIEU 


Command and Arguments 
PIFD, iblk 

Currency Indicators 

none 


indicated by iblk's host language 
variable, is declared to be a page image file for use by MDBS. DMS 
in page image posting. This command must be invoked prior to use 
of the TRBGN , TRCOM , and TRABT commands. The host language 
variable must be consistent with a string data item. The size 
(in bytes) is operating system dependent and is documented in the 
corresponding system specific manual. Xf. PIFD is invoked . it 
must a ppear b e far a the data haaa is opened . 

Examples of Command Usage 

block/direct ... EO * PIFD ("iblk") 
block/indirect ... EO ® DMS ("PIFD, iblk") 
record/direct ... EO = PIFD (iblk) 
record/indirect... EO * DMSD ("PIFD" , iblk) 


Used ; none 


Changed : 


Description 

The fully qualified file name, 


ffiEABl TEansaction AEorX TRABT 


Command and Arguments 

TRABT (no arguments) 

Currency Indicators 

Used : none Changed : most currency indicators < null 

Description 

Posting Effects (occur only if PIFD has been invoked) : 

This command aborts a complex transaction sequence that was 

initiated by the TRBGN command. A transaction cannot be aborted 
after it has already been committed (with the TRCOM command) . 
This command invokes NCI internally to ensure that no 

inconsistent currency indicators will be present. 

Logging Effects: 

TRABT may be invoked only if PIFD has been invoked, in which case 

the transaction sequence that is aborted will be ignored by the 

RCV recovery processor. 
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Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


TRABT ( ) 
DMS ("TRABT") 
TRABT ( ) 
DMS ("TRABT") 


TRBGN IRansaction ReQiN IRBGN 

Command and Arguments 

TRBGN (no arguments) or LGCPLX (no arguments) 

Currency Indicators 

Used: none Changed: none 

Description 

Posting Effects (occur only if PIFD has been invoked) : 

This command denotes the beginning of a complex transaction 
sequence, involving the use of several DML commands. The changes 
that these DML commands cause in the data base do not become 
permanent until the TRCOM command is invoked. TRCOM commits 
these changes to the data base. The TRABT command aborts a 
complex transaction. After TRCOM or TRABT has been invoked, 
TRBGN must be re-invoked to initiate another complex transaction. 
If TRBGN is re-invoked without having issued a TRABT or TRCOM 
command, a command status error is issued and the re-invocation 
of TRBGN is ignored by MDBS. DMS. 

Logging Effects: 


When this command is invoked, it indicates the beginning of a 
complex sequence of transactions. Although all transactions are 
automatically logged, RCV will ignore any transactions that 
follow TRBGN unless a subsequent TRCOM command is encountered. 
The TRBGN and TRCOM commands are used in tandem to ensure that 
either all or none (if a complex sequence is not completed) of 
the transactions, which form part of a complex sequence, are used 
by RCV during recovery. 


Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= TRBGN ( ) or 

= DMS ("TRBGN") or 
= TRBGN ( ) or 

= DMS ("TRBGN") or 


EO = LGCPLX ( ) 
EO = DMS ("LGCPLX") 
EO = LGCPLX ( ) 
EO = DMS ("LGCPLX") 


(C) COPYRIGHT 1981 Micro Data Base Systems, Inc. 


Rev. 82A 105 


MDBS DNS MANUAL 


XV. RECOVERY COMMANDS 


MDBS DNS MANUAL 


IBCQM IBansaction CQMmit TRCO M 

Command and Arguments 

TRCOM (no arguments) or LG END X (no arguments) 

Currency Indicators 

IlSfid: none Changed: none 

Description 

Posting Effects (occur only if PIFD has been invoked) : 

This command commits a complex transaction, that was initiated by 
the TRBGN command, to the data base. It has the added effect of 
clearing the contents of the page image file declared with the 
PIFD command. 

Logging Effects: 

This command indicates the end of a complex sequence of 
transactions. Any transactions logged since the last TRBGN 
command was invoked can now be processed by the RCV utility for 
data base restoration. 

Examples of Command Usage 

block/direct EO = TRCOM ( ) or EO = LGENDX ( ) 

block/indirect ... EO = DMS ("TRCOM") or EO = DMS ("LGENDX") 

record/direct ... EO = TRCOM ( ) or EO = LGENDX ( ) 

record/indirect... EO = DMS ("TRCOM") or EO = DMS ("LGENDX") 
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XVI. COMMAND STATUS DESCRIPTIONS 


A. Overview 

This chapter describes the different command status messages that 
may result from the execution of a DML command. For each command 
status (other than 0 and 255), the possible reasons for which that 
command status could be obtained are described. In almost all cases, 
the reasons themselves suggest a solution to the problem. 


B. Command Status Details 


**!** 


Invalid area name 


**!** 


Possible Causes: 

1. Typographical error in spelling area name. 

2. Incorrect order in command string. 

3. Command string not terminated properly. 


** 2 ** 


Invalid set name 


** 2 ** 


Possible Causes: 

1. Typographical error in spelling set name. 

2. Incorrect order in command string. 

3. Command string not terminated properly. 


**3*« 


Invalid record type name 


**3** 


Possible Causes: 

1. Typographical error in spelling record type name. 

2. Incorrect order in command string. 

3. Command string not terminated properly. 


** 4 *« 


Invalid data item for this record type 


**4*4 


Possible Causes: 

1. Typographical error in spelling data item name. 

2. Incorrect order in command string. 

3. Command string not terminated properly. 
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**5** Invalid owner record type for this set **5** 

Possible Causes: 

1. The record occurrence specified has not been defined as the 
owner for the set specified. 

2. Typographical error in spelling set name. 


**6** Invalid member record type for this set **6** 

Possible Causes: 

1. The record occurrence specified has not been defined as the 
member for the set specified. 

2. Typographical error in spelling set name. 


**7** 


Invalid data block name 


** 7** 


Possible Causes: 

1. A data block specified in the command string has not been 
defined. 

2. A blank data block name was specified for a "DEFINE" command. 

3. An "EXTEND" command does not immediately follow a "DEFINE" 
command. 


**g«* 


Invalid name 


**g*« 


Possible Causes: 

1. There was a syntax error related to the filename 
specification in a DBOPN or DBOPNA command. 

2. Invalid drive specification. 


**g«* 


Invalid number 


**g«* 


Possible Causes: 

1. An invalid number was passed to DBCNV or DBENV. 


**10** Syntax error on command line **10** 

Possible Causes: 

1. Self-explanatory. 


**11** Record already member/owner of set **11** 

Possible Causes: 

1. An attempt was made to connect a member record to an owner 
record for a set, when that member was already connected to 
that owner for that set. 

2. An attempt was made to connect an owner record to a member 
record for a set, when that owner was already connected to 
that member for that set. 
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**12** Record does not belong to set occurrence **12** 


Possible Causes: 

1. The record occurrence specified by the SME (or SOE) command 
is not a member or owner of the specified set. 


**13** 


Invalid area for this record type 


**13** 


Possible Causes: 

1. An area has been specified in the CRA command and the record 
type does not belong to this area. 


**14** 


Data base area already open 


**14** 


Possible Causes: 

1. The DBOPN or DBOPNA (for a given area) command was invoked 
twice. 

2. For interpretive languages, DBCLS or DBCLSA was not called. 


**15** 


Data base not closed previously 


**15** 


Possible Causes: 

1. The data base may be inconsistent since it was not closed 
previously. 


**16** 


Area not consistent with main area 


**16** 


Possible Causes: 

1. A referenced area was not consistent with the main area. 

2. An old copy of the area was on-line rather than a copy of 
the area that is up-to-date with the on-line main area. 


**17** 


No space available in data base 


** 2 . 7 ** 


Possible Causes: 

1. No space is available in the data base or area for 
processing the requested transaction. 
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**18** Set internally inconsistent ** 18 ** 


Possible Causes: 

1. This error is very rare and is returned from the following . 

commands: CRA, CRS, IMS, IOS. 

2. The error occurs due to insufficient space being available 
for pointers to be allocated. 


**19** No duplicate record allowed **19** 


Possible Causes: 

1. No duplicates have been allowed in the DDL specifications 
for the record type. 


**20** No current of run unit **20** 


Possible Causes: 

1. Self-explanatory. 

2. The user should check the currency indicators changed by the 
previous DML command. 


**2i** No current owner of set type **2i** 


Possible Causes: 

1. The command SOC, SOE, SOM, SOO or SOU was not invoked for 
this set. 

2. The command FFO, FLO, FNO, FPO, SMC, SMM, SMO or SMU 
returned command status 255 previously. 


**22** No current member of set type **22** 


Possible Causes: 

1. The command SMC, SME, SMM, SMO or SMU was not invoked for 
this s€ti« 

2. The command FFM, FLM, FNM, FPM, SOC, SOM, SOO or SOU 
returned command status 255 previously. 
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**23** No current record of record type **23** 


Possible Causes: 

1. The command CR, CRS,SRC,SRM or SRO was not previously 
invoked for this record type. 

2. The command DRC, DRM, DRO, or DRR was invoked for the 
current record of this record type. 


**24** No current user record **24** 


Possible Causes: 

1. There is no current record of a referenced user-defined 
indicator. 


**25** User-defined currency indicator not allocated **25** 


Possible Causes: 

1. A referenced user-defined indicator has not been allocated. 


**26** Current of run unit not in specified area **26** 

Possible Causes: 

1. The command FNS has been invoked with an area specified as 
an argument, and the current of run unit is not in the 
indicated area. 


**27** Inappropriate set **27** 

Possible Causes: 

1. An inappropriate set appeared as an argument. For example, 
the last set specified in a Boolean command is not system- 
owned. 

2. The first or second set specified with a Boolean command is 
N: 1. 


**28** Inappropriate record type **28** 

Possible Causes: 

1. An FRK command has been invoked on a record whose record 
type has not been declared as having a calc key. 
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**29** Cannot obtain based on record type **29** 

Possible Causes: 

1. An attempt was made to obtain a record based on a sort key 
involving the record type names. Use the corresponding find 
command and GETC instead. 


**30** 


Data out of range 


**3 o** 


Possible Causes: 

1. The data being input is outside the range of possible values 
as indicated in the DDL specifications. 

2. The value of an input argument to a DML command is not a 
permissible value for that argument. 


**31** Insufficient room in memory ** 31 ** 

Possible Causes: 

1. For languages using the SETPBF command, not enough buffer 
space has been allocated. 

2. For languages not using the SETPBF command, the DMS has been 
ORGed too high in memory, or the FIRST and LAST word in 
memory do not allow enough room. 


** 32 ** Data base opened for read access only ** 32 ** 

Possible Causes: 

1. Self-explanatory. 

2. Invalid read/write specifications in OPEN command. 


**33** Data conversion error ** 33 ** 

Possible Causes: 

1. An error has been obtained during data conversion by 
MDBS. DMS based on the DDL item specifications. 


** 34 ** No such routine ** 34 ** 

Possible Causes: 

1. Typographical error in spelling command name. 

2. Logging commands have been used without the RTL form of MDBS. 

3. A command was invoked using wrong entry point (DMS or DMSD) . 

4. A command was invoked that attempted to perform explicitly 
disabled processing (e.g., disabled by NOCALC or NOFLOAT). 
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**35** 


Duplicate data block name 


**35** 


Possible Causes: 

1. The - DEFINE command was invoked for a data block that already 
exists. 


**36** 


Invalid password 


**36** 


Possible Causes: 

1. User name/password does not exactly match DDL 
specifications. 


**37** 


Invalid number of arguments 


**37** 


Possible Causes: 

1. Too many arguments specified in command string. 


**38** 


Data base not open 


**38** 


Possible Causes: 

1. A DM L command, needing to access the data base, has been 
invoked before the data base was opened. 


**39** Set not sorted **39** 

Possible Causes: 

1. The FOSK or FMSK command is invoked on a non-sorted set. 


** 40 ** 


User may not read this set 


**40 * * 


Possible Causes: 

1. The user's read access codes have no common elements with 
the read access codes of the set being processed. 
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User may not write this set 


**41** 


Possible Causes: 

1. The user's write access codes have no elements in common 
with the write access codes of the set being processed. 


**42** 


User may not read this record 


**42** 


Possible Causes: 

1. The user's read access codes have no elements in common with 
the read access codes of the record being processed. 


**43** 


User may not write this record 


** 43 ** 


Possible Causes: 

1. The user's write access codes have no common elements with 
the write access codes of the record being processed. 


** 44 ** User may not read this item ** 44 ** 


Possible Causes: 

1. The user's read access codes have no elements in common with 
the read access codes of the item being processed. 


** 45 ** 


User may not write this item 


** 45 ** 


Possible Causes: 

1. The user's write access codes have no elements in common 
with the write access codes of the item being processed. 


** 46 ** User may not read this area ** 46 ** 


Possible Causes: 

1. The user's read access codes have no elements in common with 
the read access codes of the specified area. 
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** 47 ** User may not write this area ** 47 ** 

Possible Causes: 

1. The user's write access codes have no elements in common 
with the write access codes of the specified area. 


**4g** Ho value labels defined for this field ** 48 ** 

Possible Causes: 

1. The specified field presently has no value labels. 


**49** Invalid data base key **49** 

Possible Causes: 

1. The value input to the SCD command is not the data base key 
for a valid record occurrence in the data base. 

2. A record whose data base key was formerly saved by SDC may 
have since been deleted or moved. 


** 50 ** Checksum error ** 50 ** 

Possible Causes: 

MDBS. DMS automatically closes the data base when this error 
occurs. 

1. An error was encountered when a checksum was being 
performed on the data base pages. 


** 51 ** Disk read or write error ** 51 ** 

Possible Causes: 

This command status is returned as a result of any I/O error. 
MDBS. DMS automatically closes the data base when this error 
occurs. Some of the possible causes are: 

1. Bad sector on disk. 

2. Disk drive misaligned. 

3. The operating system has detected an error when trying 
to read/write from/to disk. 


** 52 ** Invalid data base format ** 52 ** 

Possible Causes: 

An error was encountered when the system performed a 
synchronization check on the data base pages. MDBS. DMS 
automatically closes the data base when this error occurs. 
This may mean that: 

1. Disk is in the wrong drive. 

2. The correct area disk is not on-line. 


(C) COPYRIGHT 1981 Micro Data Base Systems, Inc. 


Rev. 85A 115 



MDBS QMS MANUAL 


-XVI. COMMAND STATUS - 


MDBS DMS MANUAL 


**53** Data base not expanded ** 53 ** 

Possible Causes: 

1. The data base was initialized with the s or o option, but 
was not expanded with MDBS.DMU. 

** 54 ** File not present ** 54 ** 

Possible Causes: 

1. Disk in wrong drive. 

2. File name misspelled. 


**55** Log file I/O error ** 55 ** 

Possible Causes: 

1. An I/O error was encountered when trying to open the log 
file. 

2. See also Command Status 51. 


**56** Log file not current **56** 

Possible Causes: 

1. The log file is not up-to-date. 


** 57 ** Logging inhibited ** 57 ** 

Possible Causes: 

1. An I/O error was detected on the log file. 

2. The log file may already be open. 


**59** Needed area not on-line ** 59 ** 

Possible Causes: 

1. As the result of a DML command, the data base control system 
attempted to reference an area that is currently off-line. 

2. For record types, whose records can exist in any area, a CRS 
was invoked without having on-line the first (as specified 
in the DDL) extra area with sufficient space. 

3. FFS or FNS was invoked for an off-line area. 

4. All areas allowing pointer indices were not on-line for data 
base alteration. 


**60** Data base not available **60** 

Possible Causes: 

1. This command status is returned only when multiple users are 
accessing the data base. 

2. The user is not allowed to open the data base because some 
other user has opened the data base on an exclusive basis. 
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**61** Exclusive open refused ** 51 ** 

Possible Causes: 

1. This command status is returned only when multiple users are 
accessing the data base. 

2. An exclusive open was not granted as some other user had the 
data base already open. 


**62** Operation rejected due to active lock **62** 

Possible Causes: 

1. This command status is returned only when multiple users are 
accessing the data base. 

2. The operation requested was not performed since there was an 
active lock on the record or set specified. 

3. The run unit is attempting to access a record when the 

access request, if granted, would cause a deadlock 

situation. 

4. The error is issued after the waiting time specified with 
MCC is exhausted. 

5. The run unit encountering this situation can invoke NCI (and 
TRABT, if applicable) and restart its processing. This is 
not advisable if the run unit is in the midst of logging a 
complex transaction. 


**63** Operation rejected due to passive lock **63** 

Possible Causes: 

1. This command status is returned only when multiple users are 
accessing the data base. 

2. The operation requested was refused as there was a passive 
lock on the record specified. 

3. The run unit is attempting to access a record when the 
access request, if granted, would cause a deadlock 
situation. 

4. The error is issued after the waiting time specified with 
MCC is exhausted. 

5. The run unit encountering this situation can invoke NCI (and 
TRABT, if applicable) and restart its processing. This is 
not advisable if the run unit is in the midst of logging a 
complex transaction. 

6. The SYSTEM record cannot be actively locked because it is 
always the current owner of every system-owned set (i.e., it 
is always passively locked) . 


**65** Invalid use of CALC record **65** 

Possible Causes: 

1. The CRA command was used for a record type having a calc 
key. 
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**56** Record may not be removed from fixed set ** 66 ** 

Possible Causes: 

1. The retention for the set specified has been declared as 
fixed in the DDL specifications. 


**67** User count exceeded **67** 

Possible Causes: 

1. Too many run units attempted to concurrently access the data 
base. 


**70** No transaction in progress **70** 

Possible Causes: 

1. The TRABT, TRCOM, or LGENDX command was invoked when no 
complex transaction was in progress. 

2. TRBGN or LGCPLX has not been invoked. 


** 71 ** Transaction already in progress **71** 

Possible Causes: 

1. The TRBGN or LGCPLX command was invoked before the prior 
complex transaction was terminated by a TRABT, TRCOM or 
LGENDX command. 


**72** Posting not active **72** 

Possible Causes: 

1. The TRABT command was invoked without having previously 
invoked PIFD. 

2. PIFD has not been invoked before opening the data base. 


** 73 ** Posting table overflow ** 73 ** 

Possible Causes: 

1. This command status can be returned from TRCOM or TRABT when 
posting is active. 

2. The transaction is committed to the data base, even though a 
TRABT was attempted. 

3. Consider defining several shorter transaction sequences to 
replace the existing transaction sequence. 

** 74 ** Log file not present ** 74 ** 

Possible Causes: 

1. Using the RTL form of MDBS, the data base was opened without 
the log file being present. Processing continues. 
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** 75 ** Unable to re-insert record into all sets **75** 

Possible Causes: 

1. The value of a sort key field changed and there was 
insufficient memory for resorting the affected set 
occurrences. The record is removed from all set occurrences 
for which there is insufficient resorting room. 


**80** Load error from DMSLDR **80** 

Possible Causes: 

1. An attempt was made to load a non-executable file. 

2. There are presently too many operating system files open to 
allow another to be opened. 


**81** Communications Failure ** 8 i** 

Possible Causes: 

1. This command status can appear only in versions of the system 
that require interprocess communication (e.g., multiuser 
versions) . 

2. It indicates that an unexpected communication error was 
encountered during interprocess communication (e.g., a user 
tries to start a run unit while the data base control system 
is not executing). 
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**100-199** Catastrophic errors **100-199** 

Command status errors 100 through 199 are particular cases of a 
general "catastrophic" error, which would result in the integrity of 
the data base being destroyed. If any of these extremely rare command 
status errors is obtained, the user should contact the Micro Data Base 
Systems, Inc. technical support staff for aid in solving the problem. 
A few general notes on some of these errors are provided below. 

100 Hole table inconsistency. The table which specifies 
how much room is on each page in this area lists more 
free bytes than the page itself lists. No workaround. 

101 Invalid record occurrence. An invalid record id was 
encountered when trying to determine the record type of 
the record occurrence. If possible, remove this record 
from the set. 

103 Cannot find a connected record when resorting. When 
reordering a sorted set, problems with set connections 
are encountered. This could happen only for a "put" 
command. No workaround. 

104 Record not fully connected. When inserting a record 
into a set whose order is next or prior, a partially 
connected record was encountered. 

106 Invalid record id encountered during a comparison 
operation. When comparing two item values, an invalid 
record occurrence was encountered. 

107 Pointer not found in higher level index (DPA) during 

insertion. Invalid pointer encountered when moving a 
DPA. Possible workaround: Use Boolean commands to 

move all members into $SYSSET, remove all members from 
the original set, then reinsert the members back from 
$SYSSET . 

108 Cannot determine item type. When trying to locate an 
item, the data base control system could not find an 
item type in the item descriptors. 

109 Cannot determine record type during a "find" command. 
An invalid record id was found when building the sort 
key value. 
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110 Cannot find pointer in higher level during insertion. 

Invalid pointer encountered when splitting DPA. 
Possible workaround: Use Boolean commands to move all 

members into $SYSSET, remove all members from the 
original set, then reinsert the members back from 
$SYSSET. 

111 Cannot find pointer in higher level during removal. 

Invalid pointer encountered when removing a record from 
a set. Possible workaround: Use Boolean commands to 

move all members into $SYSSET, remove all members from 
the original set, then reinsert the members back from 
$SYSSET . 

112 SYSTEM is not owner of a set. This set is expected to 
be a system-owned set, but the set descriptor does not 
list SYSTEM as an owner. 

113 Cannot find pointer in higher level during insertion. 
Invalid pointer encountered when updating higher DPAs 
after first element has changed. Possible workaround: 
Use Boolean commands to move all members into $SYSSET, 
remove all members from the original set, then reinsert 
the members back from $SYSSET. 

114 Record reference not found in DPA during removal. The 
record for which removal was attempted is not 
completely connected in this set. 

116 Record not found in set descriptor. When doing a 
"find" operation, a record was encountered that could 
not be found in the set descriptor for this set. 

117 SYSTEM record DPA not found. When doing a "find" 
operation, a record was encountered that could not be 
found in the set descriptor for this set. 
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119 Invalid record type in set descriptor. When doing a 
"find" operation on a sorted set, a record was 
encountered that could not be found in the set 
descriptor for this set. 

120 Record not found in set descriptor. When removing a 
record from a set, a record was encountered that could 
not be found in the set descriptor for this set. 

121 Invalid record type encountered during Boolean 
operation. An invalid record id was encountered when 
trying to determine the record type of the record 
occurrence. If possible, remove the record from the 
set . 

124 Record not found in set descriptor. When checking for 
duplicates, a record was encountered that could not be 
found in the set descriptor for this set. 

126 Error in locating record. An invalid record id was 
encountered when trying to determine the record type of 
the record occurrence. If possible, remove the record 
from the set. 

130 Master unable to deallocate user descriptor. The user 
descriptor was not found when processing user logout. 
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Appendix A 


A. Introduction 

For purposes of upward compatibility from MDBS Version 1 to MDBS 
Version 3a, additional commands and alternative command names are 
available in Version 3a. The additional commands primarily involve 
the use of a kind of currency indicator not described earlier in this 
manual. In Version 3a, every record type has a current record, 
provided the DDL Analyzer was invoked with the -v option. At any 
moment during the execution of a run unit, one occurrence of a record 
type is the current record occurrence (CRO) of that record type. If a 
schema has nine record types, there are nine currency indicators 
beyond those described earlier in this manual. Although these 
additional currency indicators exist in Version 3a, they are never 
ifiSiiirfid for processing; they exist solely to provide upward 
compatibility so that application programs written for Version 1 can 
be used by Version 3a with only minimal (if any) changes. 

The effects of a few Version 3 DML commands differ slightly, in 
their effect on currency indicators, from Version 1 commands of the 
same name. This manual fully explains the effect of each Version 3 
command. Most notable among the differences are those for the FMSK, 
FOSK, RMS, DR M and DRO. In Version 3, the FMSK (FOSK) "wildcard" 
feature leaves the current member (owner) indicator positioned at the 
next record rather than the prior record as is the case with the 
Version 1 FMSK (FOSK). The Version 3 remove and delete commands do 
not leave the set's current member (or current owner for DRO) 
indicator null as they do in Version 1. The next member (or owner) 
becomes current. Also note that the Version 3 SMM, SMO and SMC do not 
return a command status of 12 when there is no owner. They return a 
command status of 255 in this situation. Similarly, the Version 3 SMR 
(described in this appendix) will return a 255 command status, rather 
than a 12 as in Version 1. 


B. Alternative Command Names 


Alternative Command 
Name (Supported in 

ACS 

CLOSE 

CMT 

COT 

ERRSET 

FINDM 

FINDO 

OPEN 

SFC 

SFM 

SFO 

STAT 

TOGGLE 


Command Name 
Us£d_in_iius_Manual 
IMS 
DBCLS 
TMT 
TOT 
VARCS 
FMI 
FOI 
DBOPN 
PFC 
PFM 
PFO 

DBSTAT 

DBENV 
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The Version 3a TOGGLE, OPEN and STAT commands (while identical to 
DBENV, DBOPN and DBSTAT respectively) differ slightly from the Version 
1 TOGGLE, OPEN and STAT commands. See the descriptions of DBENV, 
DBOPN and DBSTAT in this manual. 


C. Additional Commands 


AMS 


Add Member to Set 


AMS 


Command and Arguments 
AMS, rec, set-1 
Currency Indicators 

IlSfid: CO (set-1) Chanssch CM (set-1) < CRO(rec) 

CRO (rec) 


Description 

The record that is current record occurrence of rec becomes 
connected to the current owner of set-1. This new member for the 
current owner of set-1 is made the current member of set-1. The 
insertion of this new member record among the existing member 
records, connected to the current owner of set-1, is made in 
accordance with the member order declared for set-1 in the DDL 
specification. 

The current record occurrence of rec must be an occurrence of a 
record type that is a member of set-1. A user must have write 
access to set-1, in order to connect a member record to an owner 
record. 


Examples of Command Usage 


block/direct 
block/indirect ... 
record/direct ... 
record/indirect. . . 


EO 

= AMS 

EQ 

= DMS 

EO 

= AMS 

EO 

= DMS 


( "rec, set-1") 
("AMS, rec, set-1") 
("rec, set-1") 

( "AMS, rec, set-1") 
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CE 


Create Record 


CB 


Command and Arguments 
CR,rec 

Currency Indicators 


USfid: none 

Changed : 

CRU 

<— 

— newly 

created 

record 



CRO (rec) 

<— 

— newly 

created 

record 

... if rec is AUTO 

... if rec 

is AUTO 





member of set 

member 

of set 





CO (autoset) 


CM (autoset) 


— newly 

created 

record 

... if rec is AUTO 

...if rec 

is AUTO 





owner of set 

owner 

of set 





CM (autoset) 


CO (autoset ) < — 

— newly 

created 

record 


Description 

An occurrence of the record type rec is created. This occurrence 
has no data. No range checking is performed. 

The physical placement of the newly created record is consistent 
with the DDL specification for rec (either CALCed, clustered, or 
system-determined). In order to create the record, a user must 
have write access to rec, to the area in which the record is to 
be created, and to all sets in which the record type participates 
as an automatic owner or member. If a user does not have this 
security clearance, a command status error is returned, the 
record is not created, and no currency indicator is changed. 

If rec has been declared to be the AUTO member of a set, then the 
newly created record is automatically connected to the current 
owner of that set and the new record becomes the current member 
of that set. The connection takes place according to the member 
order specified with the DDL (SORTED, FIFO, etc.). If the member 
order for the set is NEXT, then the new record is connected 
(i.e., logically inserted) immediately after the set's current 
member. If there is no current member, the record is inserted as 
the first member. For PRIOR member order, the new record is 
logically connected immediately before the set's current member. 
If there is no current member, the record is inserted as the last 
member . 
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If rec has been declared to be the AUTO owner of a set, then the 
newly created record is automatically connected to the current 
member of that set and the new record becomes the current owner 
of that set. The connection occurs according to the set's owner 
order, as specified with the DDL (SORTED, LIFO, NEXT, etc.). If 
the owner order for the set is NEXT (or PRIOR), then the new 
record is logically connected immediately after (or before) the 
set's current owner. If there is no current owner, the record is 
inserted as the first (last) owner. 

Examples of Command Usage 


block/direct 

EO 

= CR 

("rec* 

') 

block/indirect ... 

EO 

= DMS 

( "CR, 

. rec") 

record/direct 

EO 

= CR 

("rec* 

') 

record/indirect. . . 

EO 

= DMS 

( "CR, 

■ rec") 


DRR Delete Record that is current Record occurrence DRR 


Command and Arguments 
DRR, rec 

Currency Indicators 

Used: CRO(rec) Changed: CRO(rec) null 

CRU null 

also see description 

Description 

The record that is the current record occurrence of rec is 
disconnected from all set relationships and is physically deleted 
from the data base. The current record of rec and the current of 
run unit becomes null. If the deleted record is the current 
owner of any set, the current member of any set, or the current 
record of any user-defined indicator, then those indicators 
become null. If a user does not have write access to the current 
of run unit's record type, to the record's area and to all sets 
in which that record type participates, then no deletion occurs, 
no currency indicator changes, and a command status error is 
returned. 

Examples of Command Usage 

block/direct ... EO = DRR ("rec") 
block/indirect ... EO = DMS ("DRR, rec") 
record/direct ... EO = DRR ("rec") 
record/indirect... EO = DMS ("DRR, rec") 
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GETR get data from Record GEIB 


Command and Arguments 
GETR, rec, oblk 
Currency Indicators 

Used: CRO(rec) Changed: none 

Description 

All data values in the current record occurrence of rec are 
returned in the host language variables oblk. The types, sizes 
and sequence of these variables must be consistent with the data 
items that make up the rec record type. A command status error 
is returned if a user does not have read access to all data items 
of the rec record type. 

Examples of Command Usage 

block/direct ... EO = GETR ("rec, oblk") 
block/indirect ... EO = DMS ( "GETR, rec, oblk") 
record/direct ... EO = GETR ("rec", oblk) 
record/indirect... EO = DMSD ( "GETR, rec", oblk) 


GEB Set field from Record GFR 


Command and Arguments 
GFR , itm, rec , oblk 
Currency Indicators 

LLSfid: CROC rec) Changed: none 

Description 

The value of the item data item (field) in the current record 
occurrence of rec is returned in the host language variable of 
oblk. The type and size of this variable must be consistent with 
the type and size of itm in the DDL specification. A command 
status error is returned if a user does not have read access to 
the itm field. 

Examples of Command Usage 

block/direct ... EO = GFR ( "itm, rec, oblk") 
block/indirect ... EO = DMS ( "GFR, itm, rec, oblk") 
record/direct ... EO = GFR ("itm, rec", oblk) 
record/indirect... EO = DMSD ( "GFR, itm, rec", oblk) 
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PPTR PUT data into Record POTR 


Command and Arguments 
PUTR, rec, iblk 
Currency Indicators 

Used: CRO(rec) Changed: none 

Description 

Data values of the iblk host language variables put into the 
current record occurrence of rec. The types, sizes and sequence 
of these variables must be consistent with the data items that 
make up the rec record type. A command status error is returned 
if the user does not have write access to all data items that 
make up the rec record type and to the area containing the record 
to be changed. A command status error is also returned if the 
value of an iblk variable is outside the feasibility range 
defined for the corresponding data item. 

Examples of Command Usage 

block/direct ... EO = PUTR ("rec, iblk") 
block/indirect ... EO = DMS ( "PUTR, rec, iblk") 
record/direct ... EO = PUTR ("rec", iblk) 
record/indirect... EO = DMSD ( "PUTR, rec ", iblk) 


SCR Set Current of run unit based on Record SCB 


Command and Arguments 
SCR, rec 

Currency Indicators 

Used: CRO(rec) Changed: CRU< CRO(rec) 

Description 

The record that is presently the current record occurrence of rec 
becomes the new current of run unit. The current record 
occurrence of rec remains unchanged. If the user does not have 
read access to rec, a command status error is returned and the 
current of run unit is unchanged. 

Examples of Command Usage 

block/direct ... EO = SCR ("rec") 
block/indirect ... EO = DMS ("SCR, rec") 
record/direct ... EO = SCR ("rec") 
record/indirect... EO = DMS ("SCR, rec") 
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SEE 


Store field into Record 


SEE 


Command and Arguments 
SFR, itm, rec, iblk 
Currency Indicators 

Used: CRO(rec) Changed: none 


Description 

The value of the iblk host language variable is put into the itm 
field of the current record of rec. A command status error is 
returned if the user does not have write access to itm and to the 
area containing the record to be changed. A command status error 
is also returned if the value of iblk's variable is outside of 
itm 1 s feasibility range. 


Examples of Command Usage 

block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


= SFR ("itm, rec, iblk") 

= DMS ( "SFR, itm, rec, iblk") 

= SFR ( "itm, rec" , iblk) 

= DMSD ("SFR, itm, rec", iblk) 


SUB 


Set Member based on Record 


SUB 


Command and Arguments 
SMR, rec, set-1 
Currency Indicators 

Used: CRO(rec) Changed: CM (set-1 ) < CRO(rec) 

CO(set-l)^ first owner 

CRU < first owner 

Description 

Set the current member of set-1 to be the same as the current 
occurrence of rec. This command is valid only if rec is a member 
record type for set-1. The first owner of the new current member 
of set-1 becomes the new current owner of set-1 and the current 
of run unit. If the new current member of set-1 becomes null, 
the current of run unit becomes null and a command status of 255 
is returned. If a user does not have read access to both set-1 
and rec, then a command status error is returned and no currency 
indicators change. 
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Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


SMR ("rec, set-1") 

DMS ("SMR, rec, set-1") 
SMR ("rec, set-1") 

DMS ("SMR, rec, set-1") 


SOB 


Set Qwner based on Record 


SOB 


Command and Arguments 
SOR, rec, set-1 
Currency Indicators 

Used: CRO(rec) Changed: CO (set-1) « CRO(rec) 

CM ( set-1) < —first member 

CRU < -first member 


Description 

Set the current owner of set-1 to be the same as the current 
occurrence of rec. This command is valid only if rec is an owner 
record type for set-1. The first member of the new current owner 
of set-1 becomes the new current member of set-1 and the current 
of run unit. If the new current owner of set-1 becomes null, the 
current of run unit becomes null and a command status of 255 is 
returned. If a user does not have read access to both set-1 and 
rec, then a command status error is returned and no currency 
indicators change. 

Examples of Command Usage 


block/direct ... EO 
block/indirect ... EO 
record/direct ... EO 
record/indirect... EO 


SOR ( "rec , set-1 " ) 

DMS ("SOR, rec, set-1") 
SOR ("rec, set-1") 

DMS ( "SOR, rec, set-1") 


SBC 


Set Record based on Current of run unit 


SBC 


Command and Arguments 
SRC 

Currency Indicators 

Used: cru Changed: cro< cru 
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Description 

The record that is the current of run unit becomes the new 
current record occurrence of its record type. 

Examples of Command Usage 

block/direct ... EO = SRC ( ) 

block/indirect ... EO = DMS ("SRC") 
record/direct ... EO = SRC ( ) 

record/ indirect .. . EO = DMS ("SRC") 


SRM Set Record based on Member SBH 

Command and Arguments 
SRM, set-1 

Currency Indicators 

IlSfid: CM (set-1) Changed: CRCK CM(set-l) 

Description 

The record that is the current member of set-1 becomes the new 
current record occurrence of its type. 

Examples of Command Usage 

lock/direct ... EO = SRM ( "set-1") 
block/indirect ... EO = DMS ( "SRM, set-1 " ) 
record/direct ... EO = SRM ("set-1") 
record/indirect... EO = DMS ( "SRM, set-1 " ) 


SRN Set Record to Mull SEN 

Command and Arguments 
SRN,rec 

Currency Indicators 

Used: none Changed: CRO(rec)^ null 

Description 

The current record occurrence for the rec record type becomes 
null. If a user does not have read access to rec, then the 
current record occurrence is unchanged and a command status error 
is returned. 

Examples of Command Usage 

block/direct ... EO = SRN ("rec") 

block/indirect ... EO = DMS ("SRN, rec") 

record/direct ... EO = SRN ("rec") 

record/indirect ... EO = DMS ("SRN, rec") 
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SRQ 


Set Record based on Qwner 


SBQ 


Command and Arguments 
SRO, set-1 

Currency Indicators 

Used: co(set-i) Cbanasd: CRO« -CO(set-l) 

Description 

The record that is the current owner of set-1 becomes the new 
current record occurrence of its type. 


Examples of Command Usage 


block/direct 

EO 

= SRO 

( "set- 

■1") 

block/indirect ... 

EO 

= DMS 

( "SRO, 

- set-1") 

record/direct 

EO 

= SRO 

( "set- 

-1") 

record/indirect. . . 

EO 

= DMS 

("SRO, 

• set-1") 
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DML Command Formats 
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ALTEOS (no arguments) 89-90 

AMM,set-l, set-2, set-3 82 

AMO,set-l,set-2,set-3 83 

AOM,set-l,set-2, set-3 83-84 

AOO, set-1, set-2, set-3 84-85 

AUI , iblk 67-68 

CCU, iblk 68-69 

CRA, rec , area , iblk 54-55 

CRS,rec,iblk 55-56 

DBCLS (no arguments) 69 

DBCLSA,area 70 

DBCNV, iblk 70-70.1 

DBENV , iblk 70.1-70.2 

DBINIT , host language variable 90 

DBOPN,iblk 71-72 

DBOPNA, area , iblk 72-73 

DBSAVE (no arguments) 73-74 

DBSEL,host language variable 90 

DBSTAT , oblk 74 

DEFINE, blk , list 90.1 

DMSSJP,host language jump descript ion, command status array . . . .90.2 

DRC (no arguments) 63-64 

DRM, set-1 64 

DRO, set-1 65 

EXTEND, blk , list 90.2-91 

FDRK , rec , iblk 12-13 

FFM, set-1 13 

FFO, set-1 14 

FFS,area (area is optional) 14-15 

FLM, set-1 15 

FLO, set-1 15-16 

FMI , item, set-1 , iblk 16-17 

FMSK, set-1, iblk 17-18 

FNM, set-1 18 

FNMI , itm, set-1 , iblk 19 

FNMSK, set-1, iblk 19-20 

FNO, set-1 20-21 

FNOI, itm, set-1, iblk 21-22 

FNOSK, set-1, iblk 22-23 

FNS,area (area is optional) 23-24 

FOI , item, set-1 , iblk 24 

FOSK, set-1, iblk 25 

FPM, set-1 26 

FPMI, itm, set-1, iblk 26-27 

FPMSK, set-1, iblk 27-28 

FPO, set-1 28-28.1 

FPOI , itm,set-l , iblk 28.1 

FPOSK , set-1 , iblk 28.2 

FRK, rec, iblk 28.3 

GETC,oblk 30 

GETM, set-1 , oblk 30 

GETO , set-1 ,oblk 31 

GFC, itm, oblk 31 

GFM, itm, set-1, oblk 32 

GFO, itm, set-1 , oblk 32 
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GMC, set-1, oblk 

GOC, set-1, oblk 

GTC,oblk 

GTM, set-1 ,oblk 

GTO, set-1 , oblk 

IMS, set-1 

IOS, set-1 

LGCPLX (no arguments) .... 
LGENDX (no arguments) .... 

LGFILE, iblk 

LGFLSH (no arguments) .... 

LGMSG, iblk 

MAU, iblk 

MCC,iblk 

MCF (no arguments) 

MCP (no arguments) 

MPL, iblk 

MRTF,rec (rec is optional) . 

MRTP , rec 

MSF, set-1 (set-1 is optional) 

MSP, set-1 . 

NCI (no arguments) ..... 

ODRK , rec ,blk 

OFM, set-1 , oblk 

OFO, set-1 , oblk 

OLM, set-1, oblk 

OLO, set-1, oblk 

OMI, itm, set-1 ,blk 

OMSK, set-1, blk 

ONM, set-1, oblk 

ONMI, itm, set-1, blk 

ONMSK, set-1, blk 

ONO, set-1, oblk 

ONOI, itm, set-1, blk 

ONOSK, set-1, blk. 

OOI , itm, set-1 , blk . ..... 
OOSK, set-1, blk ....... 

OPM, set-1, oblk 

OPMI , itm, set-1 , blk 

OPMSK, set-1, blk 

OPO, set-1, oblk 

OPOI, itm, set-1, blk 

OPOSK, set-1, blk 

ORK , rec , blk 

PFC, itm, iblk 

PFM, itm, set-1 , iblk 

PFO, itm, set-1, iblk 

PIFD, iblk 

PUTC, iblk . ......... 

P UTM , set— 1, iblk. . . . . . © 

PUTO, set-1 , iblk 

RMS, set-1 

ROS, set-1 

RSM, set-1 

RSO, set-1 


. .75 
. .75 
. .76 
. .76 
. .77 
57-58 
. .58 
. 105 
. 106 
. 102 
. 103 
. 103 

95- 96 
. .96 

96- 97 
. .97 
. .91 
. .98 
. .98 
. .99 
. .99 
. ©77 
.32.1 
.32.2 
.32.3 
.32.4 
.32.5 
.32.6 
.32.7 
.32.8 
.32.9 

32.10 

32.11 

32.12 

32.13 

32.14 

32.15 

32.16 

32.17 

32.18 

32.19 

32.20 

32.21 

32.22 
. .34 
34-35 
. .35 
. 104 
. .36 
. .36 
. .37 
. .59 
. .60 
60-61 
. .61 
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SCD , iblk 40.1 

SCM, set-1 40.1-40.2 

SCN (no arguments) 40.2 

SCO, set-1 40.2 

SCU , iblk 41 

SDC ,oblk 41-42 

SETPBF , list 92 

SMC, set-1 42-43 

SME, set-1 43 

SMM, set-1 , set-2 43-44 

SMN, set-1 44 

SMO, set-1 , set-2 44-45 

SMU, set-1 , iblk 45 

SOC, set-1 46 

SOE, set-1 46-47 

SOM, set-1 , set-2 47 

SON, set-1 47-48 

SOO, set-1, set-2 48 

SOU, set-1, iblk 49 

SUC, iblk 49-50 

SUM, set-1 , iblk 50 

SUN, iblk 50-51 

SUO, set-1, iblk 51 

SUU , iblk 52 

TCN (no arguments) 78 

TCT , rec 7 8 

TMN, set-1 78.1 

TMT, rec , set-1 78.1 

TON, set-1 78.2 

TOT, rec ,set-l 78.2 

TRABT (no arguments) 104 

TRBGN (no arguments) 105 

TRCOM (no arguments) 106 

TUN, iblk 79 

UNDEF (no arguments) 92-92.1 

VARCMiD , host language variable. 92.1 

VARCS,host language variable 92.1 

XMM, set-1, set-2, set-3 85-86 

XKO, set-1, set-2, set-3 . .86 

XOM, set-1 , set-2, set-3 87 

XOO, set-1, set-2, set-3 .88 
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ALTEOS (ALTer Rnd Qf Set) 89-90 

AMM (And of Members with Members) 81,82 

AMO (And of Members with Qwners) 81,83 

AOM (And of Qwners with tiembers) 81,83-84 

AOO (And of Qwners with Qwners) 81,84-85 

AUI (Allocate User Indicators) 67-68 

CCU (Check Current of run unit against User indicator) . . . 68-69 

CRA (Create Record in Area) 54-55 

CRS (Create Record and Store) 55-56 

DBCLS (Qata Rase CLoRe) 69 

DBCLSA (Rata Rase CLoSe for Area) 70 

DBCNV (Rata Rase format CoNVversion) 70-70.1 

DBENV (Rata Rase RMironment) 70.1-70.2 

DBINIT (Rata Rase control system INIT ializat ion) 90 

DBOPN (Rata Rase QReR) 68,69,71-72,103 

DBOPNA (Rata Rase QReR Area) 72-73 

DBSAVE (Rata Rase SAVE ) 9,69,73-74,104 

DBSEL (Rata Rase SELection) 90 

DBSTAT (Rata Rase STAT ist ics) 74 

DEFINE ( DEFINE data block) 72,90.1 

DMSSJP (RtLS. Ret Rum£) 90.2 

DRC (Relete Record that is Current) .... 63-64 

DRM (Relete Record that is Member) 64 

DRO (Relete Record that is Qwner) 65 

EXTEND ( EXTEND data block) 90.2 

FDRK (Rind Ruplicate Record based on calc Rey) 12-13 

FFM (Rind Rirst Member) 13,18,40 

FFO (Rind Rirst Qwner) 14,20,40 

FFS (Rind Rirst Sequential record) 14-15 

FLM (Rind Rast Member) 15,24 

FLO (Rind Rast Qwner) 15-16,24 

FMI (Rind Member based on data item) 16-17,19 

FMSK (Rind Member based on Sort Rey) 17-18 

FNM (Rind Rext Member) 18 

FNMI (Rind Rext Member based on data item) 19 

FNMSK (Rind Rext Member based on Sort Rey 19-20 

FNO (Rind Rext Qwner) 20-21 

FNOI (Rind Rext Qwner based on data item) 21-22 

FNOSK (Rind Rext Qwner based on Sort Rey) 22-23 

FNS (Rind Rext Sequential record) 23-24 

FOI (Rind Qwner based on data item) 24 

FOSK (Rind Qwner based on Sort Rey) 25 

FPM (Rind Rrior Member) 26 

FPMI (Rind Rrior Member based on data item) 26-27 

FPMSK (Rind Rrior Member based on Sort Rey .......... 27-28 

FPO (Rind Rrior Qwner) 28-29 

FPOI (Rind Rrior Qwner based on data item) 28.1 

FPOSK (Rind Rrior Qwner based on Sort Rey) 28.2 

FRK (Rind Record based on calc Rey) 13,28.3 

GETC ( GET data from Current of run unit) 30 

GETM ( GET data from Member) 30 

GETO ( GET data from Qwner) 31 

GFC (Qet Rield from Current of run unit) 31 

GFM (Qet Rield from Member) 32 

GFO (Qet Rield from Qwner) 32 
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GMC (Get Hember Count) .75 

GOC (Set Qwner Count) 75 

GTC (Get Xype of Current of run unit) 76 

GTM (Get Xype of Hember) 76 

GTO (Get Xype of Qwner) 77 

IMS (Insert Hember into Get) 57-58 

IOS (Insert Qwner into Get) .58 

LGCPLX (LoG start of ComPLeX transactions) ............ 105 

LGENDX (LoG END complex, transactions) .............. 106 

LGFILE (LoG FILE specification) ............... 101,102 

LGFLSH (LoG file buffer ELuGH) 101-102,103 

LGMSG (LoG file HeGsaGe) 101,102,103 

MAU (Hultiuser Active User indicators 95-96 

MCC (Hultiuser Contention Count) 96 

MCF (Hultiuser Current of run unit £ree) 96-97 

MCP (Hultiuser Current of run unit Erotect) 97 

MPL (Hultuser Erior ity Level) . 91 

MRTF (Hultiuser Eecord Xype £ree) 98 

MRTP (Hultiuser Eecord Xype Erotect) 98 

MSF (Hultiuser Get £ree) ........... .99 

MSP (Hultiuser Get Erotect) .................. .99 

NCI (Hull all Currency Indicators) .............. .77 

ODRK (Obtain Duplicate Eecord based on calc Key) .32.1 

OFM (Obtain £irst Hember) .32.2 

OFO (Obtain Eirst Owner) 32.3 

OLM (Obtain Last Hember) .32.4 

OLO (Obtain Last Owner) 32.5 

OMI (Obtain Hember based on data Item) 32.6 

OMSK (Obtain Hember based on Gort Key) .32.7 

ONM (Obtain Hext Hember) 32.8 

ONMI (Obtain Hext Hember based on data Item) 32.9 

ONMSK (Obtain Hext Hember based on Gort Key) 32.10 

ONO (Obtain Hext Owner) 32.11 

ONOI (Obtain Hext Owner based on data Item) .... 32.12 

ONOSK (Obtain Hext Owner based on Gort Key) .......... 32.13 

OOI (Obtain Owner based on data Item) 32.14 

OOSK (Obtain Owner based on Gort Key) ............ 32.15 

OPM (Obtain Erior Hember) ......... . 32.16 

OPMI (Obtain Erior Hember based on data Item) 32.17 

OPMSK (Obtain Erior Hember based on Gort Key) 32.18 

OPO (Obtain Erior Owner) 32.19 

OPOI (Obtain Erior Owner based on data Item) 32.20 

OPOSK (Obtain Erior Owner based on Gort Key) 32.21 

ORK (Obtain Eecord based on calc Key) 32.22 

PFC (Rut data into £ield of Current of run unit) 34 

PFM (Eut data into £ield of Hember) 34-35 

PFO (Eut data into £ield of Owner) 35 

PIFD (Eage Image £ile Declaration) ........ .9,69,72,101,104 

PUTC ( PUT data into Current of run unit) ........... 35-36 

PUTM ( PUT data into Hember) .................. .36 

PUTO ( PUT data into Owner) ................... .37 

RMS (Eemove Hember from Get) 59 

ROS (Eemove Owner from Get) 60 

RSM (Eemove all Get Hembers) 60-61 

RSO (Eemove all Get Owners) 61 
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SCD (Set Current of run unit to Data base key) 40.1 

SCM (Set Current of run unit based on Member) 40.1-40.2 

SCN (Set Current of run unit to Hull) 40.2 

SCO (Set Current of run unit based on Qwner) 40.2 

SCU (Set Current of run unit based on User indicator) 41 

SDC (Cave D.ata base key for Current of run unit) 41-42 

SETPBF ( SET £age £u£.fer region) 89,92 

SMC (Set Member based on Current of run unit) 42-43 

SME (Set Member to current of run unit (exception)) 40,43 

SMM (Set Hember based on Hember) 43-44 

SMN (Set Hember to Mull) 40,44 

SMO (Set Hember based on Qwner) 44-45 

SMU (Set Hember based on User indicator) 45 

SOC (Set Qwner based on Current of run unit) 39,46 

SOE (Set Qwner to current of run unit (exception)) . . . .40,46-47 

SOM (Set Qwner based on Hember) 47 

SON (Set Qwner to Mull) 41,47-48 

SOO (Set Qwner based on Qwner) 48 

SOU (Set Qwner based on User indicator) 49 

SUC (Set User indicator to Current of run unit) 49-50 

SUM (Set User indicator to Hember) 50 

SUN (Set User indicator to Mull) 50-51 

SUO (Set User indicator to Qwner) 51 

SUU (Set User indicator to User indicator) 52 

TCN (Test Current of run unit for Mull) 78 

TCT (Test Current of run unit Type) 78 

TMN (Test Hember for Mull) 78.1 

TMT (lest Hember Type) 78.1 

TON (Test Qwner for Mull) 78.2 

TOT (Test Qwner Type) 78.2 

TRABT (Transaction ADorl) 10,101,104 

TRBGN (Transaction UeQiM) 10,101-102,105 

TRCOM (TUransact ion CQMm it) 10,101,106 

TUN (Test User for Mull) 79 

UNDEF ( UNDEF ine data blocks) 92-92.1 

VARCMD ( VAR iable for QoMmanQ string) 92.1 

VARCS ( VAR iable for Command Status) 92.1 

XMM (exclude Members from Members) 81,85-86 

XMO (exclude Members from Qwners) 81,86 

XOM (exclude Qwners from Members) 82,87 

XOO (exclude Qwners from Qwners) ....... .82,88 
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active lock 

application development .... 

area file name 

assignment commands 

AUTO sets 

back-up 

BLF 

Boolean commands 

buffer flushing 

calc key 

check suppression 

close data base 

clustering 

command classes 

command description notation 

command form 

command status 

command string 

connect commands 

counts of records 

creation commands 

current member 

current of run unit 

currency owner 

currency indicators 

databasekey 

data block definition 

data blocks 

Data Manipulation Language . 

date format conversion 

deadlock prevention 

deletion commands 

difference operators 

disconnect commands 

environment controls 

feasibility range 

find commands 

fixed retention 

flush of log file buffers .. 

flush of page buffers 

get data commands 

host language 

IBS 

IDML 

intersection operators 

log file 

MANUAL sets 

modify commands 

multiuser environment 

multiuser locking commands . 


8,70.2,77/93-95 


72-73 

39-52,70.2 

54-58 

9-10,101 

2 

81-88 

70.2,73-74 

12-13,25,28.3,32.1,32.22,33 

70.2 

69-70 

53 

5 

7-8 

6-7 

6,8,90.2-92,94,107-118 

7 

57-58 

75-76 

53-56 

3-5,8,39 

4,8,39 

3-5,8,39 

3-5,8,29,33,39-52,57,59,63,72,77,93,95 

39,40.1,41-42 

90-92,96 

3,8 

1-9 

70-70.1 

9 

63-65 

81,85-88 

59-63 

70-70.2 

33,53 

11-28.3,70.2 

59 

102,104 

9,69,73-74 

29-32 

1-3 

2 

2 

31-85 

10,101-102 

54-58 


2,8-9,69,70.1-72,89,91,95-97 
93-99 
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null commands 39,41,44,67,77 

null dates 70.1 

null times 70.1 

obtain commands 29,32.1-32.22 

open data base 71-73 

page buffer region 2,74,89,91 

page image file 9-10,69,72,101 

passive lock ...... o..... 8,70.2,93—97 

p e r f o r ma nc e tunxng ............. ................. .......... 70.2,89,91 

processing modes 71-72 

program buffers 89,91 

program record types 3,8 

QRS 2,93 

RCV 10,101-103 

RDL 2 

recovery 9-10,101-102 

recovery commands 101-106 

retrieval commands 29-32.22 

run unit 4,8 

RTL 9-10,69,101-102 


sequential search 12,14-15,23-24 

sort key ... 11,17-18,20-23,25,32.7,32.10,32.13,32.15,32.19,32.21,70.2 


s p e c i a 1 c o mma nd s ..o.*.. ...... ........ ............... ........... 89—92 

speed (see performance tuning) 

statistics 74-75 


SSYSSET 


81-88 


throughput priority level 89,91,95 

type determination 77-79 


user-defined indicators 5,8,40,67-68,81-88 


user name 


71 


user password 71 

utility commands 67-79 

virtual paging 2,74 
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DOCUMENTATION COMMENT FORM 


MDBS Document Title: 


We welcome and appreciate all comments and suggestions that can 
help us to improve our manuals and products. Use this form to 
express your views concerning this manual. 

Please do not use this form to report system problems or to 
request materials, etc. System problems should be reported to 
MDBS by phone or telex, or in a separate letter addressed to the 
attention of the technical support division. Requests for 
published materials should be addressed to the attention of the 
marketing division. 


Sender : 


(name) 


(position) 


(company) 


(telephone) 


(address) 


(city, state, zip) 


COMMENTS: 

Areas of comment are general presentation, format, organization, 
completeness, clarity, accuracy, etc. If a comment applies to a 
specific page or pages, please cite the page number (s) . 


Continue on additional pages, as needed. Thank you for your response. 



